|
| 1 | +--- |
| 2 | +layout: page |
| 3 | +authors: ["Zhian N. Kamvar"] |
| 4 | +teaser: "Updates to instructor view, doi badges, and more" |
| 5 | +title: "Release of Sandpaper 0.15.0" |
| 6 | +date: 2023-11-27 |
| 7 | +time: "09:00:00" |
| 8 | +tags: ["Lesson Infrastructure", "Community", "Carpentries Workbench", "Beta", "Dovetail"] |
| 9 | +--- |
| 10 | + |
| 11 | +This is the eighteenth post continuing [a series that we are calling "The Dovetail", |
| 12 | +about the transition to The Carpentries Workbench](https://carpentries.org/posts-by-tags/#blog-tag-dovetail) (our new lesson infrastructure). |
| 13 | +In this series, we aim to keep members of The Carpentries community abreast of |
| 14 | +the current news about [the Workbench](https://carpentries.github.io/workbench). |
| 15 | +If you are unfamiliar with The Workbench, you can [watch a video that describes |
| 16 | +the workbench and the beta phase in two minutes](https://youtu.be/x7tETGpF3-4). |
| 17 | + |
| 18 | +If you are interested in participating in discussions around The Carpentries |
| 19 | +Workbench, or if you have questions, head over to our [GitHub Discussions forum](https://github.com/carpentries/workbench/discussions). |
| 20 | + |
| 21 | +<span style='font-size: large;'>If you have used the workbench and would like to provide feedback, please |
| 22 | +<b><a href='https://carpentries.typeform.com/to/KRBl4IZM'>tell us about your experience</a>.</b></span> |
| 23 | + |
| 24 | +## Six months of success |
| 25 | + |
| 26 | +As of 16 November 2023, we acheived a milestone of 6 months where all of our lessons |
| 27 | +have been using The Workbench. Since the last update on 13 April 2023, we have |
| 28 | +seen a huge outpouring of support from the community to support the lesson |
| 29 | +transition phase that was finalized on 16 May 2023 when [Foundations of |
| 30 | +Astronomical Data Science](https://datacarpentry.org/astronomy-python/) was |
| 31 | +transitioned to use The Workbench. |
| 32 | + |
| 33 | +Since then, we have been hard at work to shore up capacity within the Core Team |
| 34 | +while fixing bugs and implementing new features such as the processing of |
| 35 | +workshop overview pages, child documents, and a `spoiler` class of fenced divs |
| 36 | +to collapse parts of the lesson. |
| 37 | + |
| 38 | +## Sandpaper 0.15.0 to be released on 29 November 2023 |
| 39 | + |
| 40 | +In this next version of the user interface to The Workbench, we have |
| 41 | +implemented features that have been requested. |
| 42 | + |
| 43 | +1. R Markdown lessons can choose to render a handout by using `handout: true` |
| 44 | + in their `config.yaml` (this will be available for all lessons with the |
| 45 | + release of pegboard 0.8.0). |
| 46 | +2. The "More" dropdown menu for the Instructor view will now also contain links |
| 47 | + to the learner materials underneath the Instructor materials. |
| 48 | +  |
| 51 | +3. For peer-reviewed lessons, adding a `doi:` with a valid DOI in the |
| 52 | + `config.yaml` will have a DOI badge to appear in the tool bar that links to |
| 53 | + the publication or archive (see image below). |
| 54 | +4. For those building the lessons in Docker, the `site/` folder is now |
| 55 | + customisable using the `SANDPAPER_SITE` environment variable. |
| 56 | + |
| 57 | +In addition, we will release {varnish} 0.4.0, which will update the visual |
| 58 | +styling of the status badges to make them more prominent. |
| 59 | + |
| 60 | +<figure> |
| 61 | + <img src='{{ site.urlimg }}/blog/2023/11/2023-11-10-doi-screen.png' alt='carpentries logo with a pale yellow badge with a blue border that says "DOI" with a doi number appended' style='border: solid 1pt black;'/> |
| 62 | + <img src='{{ site.urlimg }}/blog/2023/11/2023-11-10-beta-screen.png' alt='carpentries logo with a blue badge that says "beta"' style='border: solid 1pt black;'/> |
| 63 | + <img src='{{ site.urlimg }}/blog/2023/11/2023-11-10-alpha-screen.png' alt='carpentries logo with a yellow badge that says "alpha"' style='border: solid 1pt black;'/> |
| 64 | + <img src='{{ site.urlimg }}/blog/2023/11/2023-11-10-pre-alpha-screen.png' alt='carpentries logo with a red badge that says "pre-alpha"' style='border: solid 1pt black;'/> |
| 65 | + <figcaption> |
| 66 | + The new badge formats. |
| 67 | + </figcaption> |
| 68 | +</figure> |
| 69 | + |
| 70 | +All this along with documentation upgrades and bugfixes will be available |
| 71 | +starting on 29 November 2023, and it will automatically propogate to all lessons by |
| 72 | +5 December 2023. |
| 73 | + |
| 74 | +## Giving Thanks |
| 75 | + |
| 76 | +It has been over six months since we wrote a Dovetail blog post and needless to |
| 77 | +say, there are a lot of people that I would like to thank. I'm grateful for |
| 78 | +everyone who has taken the opportunity to open issues in The Workbench |
| 79 | +repositories to report bugs or features needed. I'm especially grateful for |
| 80 | +everyone who has additionally opened pull requests to fix these bugs. |
| 81 | + |
| 82 | +The whole reason this project works is because of the community. Full stop. |
| 83 | +Below, I list all the contributors from GitHub who have opened issues or pull |
| 84 | +requests that have lead to bugfixes or features in The Workbench, but I do want |
| 85 | +to acknowledge that there are so many more people who could be named here, |
| 86 | +including the Maintainers who have been able to give feedback directly in |
| 87 | +Maintainer meetings, Lesson Developers working in The Carpentries Incubator |
| 88 | +giving feedback about their use case, everyone from the internationalisation |
| 89 | +community whose continued efforts bring us closer to natively supporting |
| 90 | +translations, and last but not least, the brave souls who are willing to open |
| 91 | +an issue and dream that we will continue to grow. |
| 92 | + |
| 93 | +### Sandpaper |
| 94 | + |
| 95 | +Thank you to all the people who have who have contributed to or opened issues |
| 96 | +that have led to the improvement of {sandpaper} since version 0.11.15: |
| 97 | +[@froggleston](https://github.com/froggleston), |
| 98 | +[@karenword](https://github.com/karenword), |
| 99 | +[@ErinBecker](https://github.com/ErinBecker), |
| 100 | +[@fherreazcue](https://github.com/fherreazcue), |
| 101 | +[@tobyhodges](https://github.com/tobyhodges), |
| 102 | +[@milanmlft](https://github.com/milanmlft), |
| 103 | +[@apirogov](https://github.com/apirogov), |
| 104 | +[@fnattino](https://github.com/fnattino), |
| 105 | +[@tesaunders](https://github.com/tesaunders), |
| 106 | +[@mwhamgenomics](https://github.com/mwhamgenomics), |
| 107 | +[@kaijagahm](https://github.com/kaijagahm), |
| 108 | +[@jcolomb](https://github.com/jcolomb), |
| 109 | +[@klbarnes20](https://github.com/klbarnes20), |
| 110 | +[@ocaisa](https://github.com/ocaisa), |
| 111 | +[@joelnitta](https://github.com/joelnitta), |
| 112 | +[@velait](https://github.com/velait), |
| 113 | +[@cynthiaftw](https://github.com/cynthiaftw), |
| 114 | +[@debpaul](https://github.com/debpaul), |
| 115 | +[@bencomp](https://github.com/bencomp), |
| 116 | +[@ostephens](https://github.com/ostephens) |
| 117 | +and [@twrightsman](https://github.com/twrightsman) |
| 118 | + |
| 119 | +### Pegboard |
| 120 | + |
| 121 | +Thank you to all the people who have who have contributed to or opened issues |
| 122 | +that have led to the improvement of {pegboard} since version 0.5.2: |
| 123 | +[@joelnitta](https://github.com/joelnitta), |
| 124 | +[@trhallam](https://github.com/trhallam), |
| 125 | +[@tobyhodges](https://github.com/tobyhodges), |
| 126 | +[@klbarnes20](https://github.com/klbarnes20), |
| 127 | +[@beastyblacksmith](https://github.com/beastyblacksmith), |
| 128 | +[@ErinBecker](https://github.com/ErinBecker) |
| 129 | +and [@uschille](https://github.com/uschille) |
| 130 | + |
| 131 | +### Varnish |
| 132 | + |
| 133 | +Thank you to all the people who have contributed to or opened issues |
| 134 | +that have led to the improvement of {varnish} since version 0.2.16: |
| 135 | +[@brownsarahm](https://github.com/brownsarahm), |
| 136 | +[@froggleston](https://github.com/froggleston), |
| 137 | +[@tobyhodges](https://github.com/tobyhodges), |
| 138 | +[@Robadob](https://github.com/Robadob), |
| 139 | +[@marklcrowe](https://github.com/marklcrowe) |
| 140 | +and [@bencomp](https://github.com/bencomp) |
| 141 | + |
| 142 | + |
| 143 | + |
0 commit comments