The Dovetail #6: Updates from The Carpentries Workbench
This is the sixth 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
A lot has happened since the last time I provided an update (2022-07-20), just not that much on The Workbench side of things. I attended and presented at the RStudio conference 2022, took a short “staycation” to decompress (with a broken aircon, no less!), attended and presented at CarpentryCon 2022, and sat on hiring committees for our new Director of Technology. During this time, I was able to tackle some superficial aspects of the Workbench itself.
In this issue of The Dovetail, I wanted to reiterate the purpose of the Beta Phase of The Workbench (which is still on hold) because it bears repeating. We are going to be transitioning all of our lessons to use The Carpentries Workbench starting in 2023, and the Beta Phase is here to prepare the community for this day by doing the following:
- Creating awareness about The Workbench and how Workbench lessons differ from styles lessons.
- Providing a risk-free sandbox for Maintainers and Instructors to work with The Workbench version of lessons before full transition.
If we have succeeded in the above two points, we know that we can proceed with the transition of our lessons in 2023. However, The Workbench Beta Phase is designed to do more than simply make the community aware of the changes; we want to make sure The Workbench is thriving in the hands of the community. That is, we want to:
- Ensure that the tool actually meets the needs and wants of the community.
- Create champions of, and inspire future contributors to The Workbench.
When I piloted the Alpha Test of The Workbench, my goal was to make sure that it could be installed and work as expected for members of our community. The move into Beta testing means that I am confident that The Workbench is indeed stable enough to host our lessons (i.e. the official documentation for The Workbench has been continuously hosted for the last year and a half, since 2021-02-09), and I am ready for early adopters to try it out and really tell me how they feel about The Workbench.
This can only be really acheived with directed and specific feedback, which is why I’ve given the Beta Phase a fairly rigid structure in three stages. During each stage, I will be asking Maintainers and Instructors to try out different, specific, tasks and give feedback in GitHub Issues on The Workbench repository. For an extra level of detail, I am hoping that I can find some Maintainers or Instructors to provide Friction Logs, which will give me a step-by-step view into a specific process so that the exact causes of friction can be identified and smoothed out.
I really want to thank all of the current Beta Phase testers because you all have been so patient with me as we plan out this next big step for The Carpentries lesson infrastructure.
Announcements
Workbench Beta Phase Still On Hold
Just in case you did not see The Dovetail issue number 5, the Beta phase has been put on hold so that the team could focus on time-sensitive events such as CarpentryCon and hiring for two positions.
Upcoming Workbench Events
RSECon2022 (September 2022)
Toby Hodges and I will be leading a short workshop at The Conference for Research Software Engineering entitled “Collaborative Lesson Development with The Carpentries Workbench” where we will go over the principles of lesson development and how to use The Workbench to employ those principles.
Updates to The Carpentries Workbench
Since 2022-07-20,
- {sandpaper} version 0.9.0 -> 0.9.3
- Minor maintenance fixes
- Documentation of configuration keys for {sandpaper}.
- Anchor links have been added to headers and callouts.
- {varnish} version 0.2.2 -> 0.2.4
- Heading elements are now more uniform, fixing a bug in the original design.
- Sidebar navigation now says “Episodes” instead of “Expand” when collapsed.
- The hamburger navigation menu on mobile views has a border around it to make it more obviously a button.
- {pegboard} 0.3.0 -> 0.3.1
- minor update for an internal function to prepare for the CRAN release of {tinkr} 0.1.0.
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
Official Lessons
- datacarpentry/R-ecology-lesson—Data Analysis and Visualization in R for Ecologists (✅ approved by maintainers)
- datacarpentry/r-socialsci—R for Social Scientists (✅ approved by maintainer)
- datacarpentry/r-raster-vector-geospatial—Introduction to Geospatial Raster and Vector Data with R (⏳ awaiting responses)
- datacarpentry/OpenRefine-ecology-lesson—Data Cleaning with OpenRefine for Ecologists (✅ approved by maintainer)
- librarycarpentry/lc-shell—Library Carpentry: The UNIX Shell (⏳ awaiting responses)
- carpentries/instructor-training—Instructor Training (⏳ awaiting responses)
Tentative schedule for official lessons
[ON HOLD]
Community Lessons
- carpentries-incubator/git-novice-branch-pr—Version Control with Git
- carpentries-incubator/data-management-pipelines-engineering—Data management and analytic pipelines for engineers
- carpentries-incubator/markdown-intro—Introduction to Markdown
- carpentries-incubator/SDC-BIDS-IntroMRI—Introduction to MRI and BIDS
- carpentries-incubator/SDC-BIDS-dMRI—Introduction to dMRI
- carpentries-incubator/SDC-BIDS-fMRI—fMRI Imaging Analysis
- carpentries-incubator/julia-novice—A lesson exploring the Julia language
- carpentries-incubator/R-archaeology-lesson
- carpentries-incubator/python-packaging-publishing—Packaging and Publishing with Python
Participants
- Eirini Zormpa, Maintainer
- James Sadler, Maintainer
- Robin, Instructor
- Jon Haitz Legarreta Gorroño, Lesson Developer (in The Carpentries Incubator)
- Karen Word, Maintainer
- Luis J. Villanueva, Maintainer
- Jon Wheeler, Lesson Developer (in The Carpentries Incubator)
- Simon Christ, Lesson Developer (in The Carpentries Incubator)
- Maneesha Sane, Instructor
- Sarah Brown, Maintainer
- Joel Nitta, Translator
- Juan Fung, Maintainer
- Jannetta Steyn, Lesson Developer (in The Carpentries Incubator)
- Michael Joseph, Lesson Developer (in The Carpentries Incubator)
- Sarah Stevens, Lesson Developer (in The Carpentries Incubator)
- Kozo Nishida, Lesson Translation (to Japanese)
- François Michonneau, Maintainer
- Jamie Jamison, Maintainer
- Jennifer Stubbs (she/her), Instructor
- Drake Asberry, Maintainer
Tips and Tricks for Using The Workbench
During the beta phase, development on The Workbench can move rapidly. While you should be able to build your lesson successfully with any version of The Workbench, it’s a good idea to stay abreast of the packages. To keep up to date you can run the following code in R:
# 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'))
Dialogue & Discussion
Comments must follow our Code of Conduct.