Home> Blog> The Dovetail #9: Updates from The Carpentries Workbench

The Dovetail #9: Updates from The Carpentries Workbench

This is the eighth post in a series that we are calling “The Dovetail”, about the transition to The Carpentries Workbench. In this series, we aim to keep members of The Carpentries community abreast of the current news about the Workbench.

If you are interested in participating in discussions around The Carpentries Workbench, head over to our GitHub Discussions forum: https://github.com/carpentries/workbench/discussions


Beta Phase Updates

The beta phase is up and running with the first lesson: “Data Analysis and Visualisation in R for Ecologists”. The live version is at https://datacarpentry.org/R-ecology-lesson, while The Workbench version is at https://preview.carpentries.org/R-ecology-lesson. Note that The Workbench version of the lesson is a snapshot from 2022-10-17, which allows the Maintainers of the lesson to practise working with the new infrastructure before it becomes the default. On 2022-11-14, the underlying lesson repository will be converted to using the Workbench. During this time, the default URL will serve a snapshot of the lesson, and the live lesson will be served at the preview URL. Note that any pull requests that come into the lesson during that time should not come from forks created before 2022-11-14.

In the next two weeks, two further lessons will enter the beta phase:

For Instructors, here is a video showing what you can expect to see when you go to teach a lesson that is entering the beta phase:

Updates to The Carpentries Workbench

Since 2022-10-05,

  • {sandpaper} version 0.10.1 -> 0.10.4
    • A workaround for a bug in {renv} 0.16.0 has been added to prevent extra files from being committed to the renv/ folder in R lessons.
    • Weekly workflow file pull requests no longer result in pull requests with only sandpaper-version.txt changed.
  • {pegboard} 0.3.2
    • no updates :)
  • {varnish} 0.2.4 -> 0.2.6
    • Lessons that have workbench-beta, old-url, and pre-beta-date tags will now display a modified alert banner that will give information about when the lesson entered the beta phase and will link back to the default lesson URL.

To update your local Workbench installation, open R and use the following code:

# Enable repository from carpentries
options(repos = c(
  ropensci = 'https://carpentries.r-universe.dev',
  CRAN = 'https://cloud.r-project.org'))
# Download and install sandpaper in R
install.packages(c('tinkr', 'pegboard', 'sandpaper', 'varnish'))

Upcoming and Current Lessons in Workbench Beta

List of Lessons to enter Workbench Beta in 2022

LessonPre-BetaBetaPre-release
datacarpentry/R-ecology-lesson—Data Analysis and Visualization in R for Ecologists (✅ approved by maintainers)2022-10-172022-11-142023-01-23
datacarpentry/r-socialsci—R for Social Scientists (✅ approved by maintainer)2022-10-242022-11-212023-01-30
datacarpentry/r-raster-vector-geospatial—Introduction to Geospatial Raster and Vector Data with R (⏳ awaiting responses)2022-10-312022-11-282023-02-06
datacarpentry/OpenRefine-ecology-lesson—Data Cleaning with OpenRefine for Ecologists (✅ approved by maintainer)2022-11-072022-12-052023-02-13
librarycarpentry/lc-shell—Library Carpentry: The UNIX Shell (⏳ awaiting responses)2022-11-142022-12-122023-02-20
carpentries/instructor-training—Instructor Training (⏳ awaiting responses)2022-11-282023-01-092023-03-06
datacarpentry/python-ecology-lesson-es—Análisis y visualización de datos usando Python2022-12-052023-01-162023-03-13

Community Lessons

Participants

Tips and Tricks for Using The Workbench

If you are developing a lesson and you want to move a single episode to a different place in the schedule, you can use the move_episode() function:

For example, if you have the following episodes and wanted to move library before data:

  • introduction.md
  • data.md
  • software.md
  • library.md
  • outro.md

You could use the move command to interactively select where you want to insert the episode:

library("sandpaper")
move_episode("library.md", write = TRUE)

You would see a menu that prompts you to move the episode:

ℹ Select a number to insert your episode
(if an episode already occupies that position, it will be shifted down)

1. introduction.md
2. data.md
3. software.md
4. library.md
5. outro.md

Choice: 2