Transition To Workbench in May

[zkamvar]

@librarycarpentry/lc-shell-maintainers

As I hope you are already aware, we are rolling out the new lesson infrastructure, The Carpentries Workbench, across all of The Carpentries official lessons in early May 2023. This means that all Data Carpentry, Library Carpentry, and Software Carpentry lesson repositories will be modified to adopt the new infrastructure in the coming days.

You can follow the transition of this lesson repository at https://github.com/carpentries/lesson-transition/issues/67.

The transition has already taken place for several lessons, and so far the process has been running quite smoothly. You should see the transition take place with minimal disruption, but there are a few things that it is important for Maintainers to be aware of.

Here is what you can expect to happen next:

1. Any open pull requests on the repository will be closed with an automated message.
2. The repository will be set to read-only mode for a brief period while the transition occurs.
3. The new repository structure and lesson site layout will then be applied.
4. To avoid anyone accidentally pushing the old commit history back to the repository, after the transition Maintainers will need to delete and replace any existing forks and local clones they have of the lesson repository, and confirm that they have done so by replying to this issue.

I will reply here before and after the transition has taken place. If you have any questions in the meantime, please reach out to the Curriculum Team by tagging us here, e.g. @librarycarpentry/core-team-curriculum.

If you would like to read more about the new lesson infrastructure and the modified repository structure you can expect post-transition, I recommend the Infrastructure episode of the Maintainer Onboarding curriculum and the Workbench Transition Guide, which includes a side-by-side comparison of various elements of the old and new infrastructures.

[zkamvar]

This lesson will be converted to use The Carpentries Workbench To prevent accidental reversion of the changes, we are temporarily revoking write access for all collaborators on this lesson:

• [ ] @jt14den (admin)
• [x] @jmjamison (maintain)
• [ ] @ostephens (admin)
• [ ] @laufers (push)
• [ ] @chennesy (push)
• [ ] @annajiat (push)
• [x] @kaitlinnewson (maintain)
• [ ] @annaoates (maintain)
• [ ] @PhilReedData (push)
• [ ] @ragamouf (push)

If you no longer wish to have write access to this repository, you do not need to do anything further.

1. What you can expect from the transition 📹: https://carpentries.github.io/workbench/beta-phase.html#beta
2. How to update your local clone 💻: https://carpentries.github.io/workbench/beta-phase.html#updating-clone
3. How to update (delete) your fork (if you have one) 📹: https://carpentries.github.io/workbench/faq.html#update-fork-from-styles

If you wish to regain write access, please re-clone the repository on your machine and then comment here with I am ready for write access :rocket: and the admin maintainer of this repository will restore your permissions.

If you have any questions, please reply here and tag @zkamvar

[zkamvar]

The deed is done. The infrastructure takes a few minutes to bootstrap and cache the packages for the lesson build. Once the build is done, I will switch github pages to deploy from the gh-pages branch and you will have your workbench lesson.

Thank you all for your enthusiasm and your patience!

[zkamvar]

The Workbench version is now live: https://librarycarpentry.github.io/lc-shell/

In addition, here is map of commits that were changed during the transition

[PhilReedData]

I am ready for write access :rocket:

[zkamvar]

Hi @PhilReedData, thank you for following up. To shore up the security of the lesson repositories, the Curriculum Team would like to use this opportunity to tidy up the access levels we are providing to community members across the various repos. According to our records, you're not a Maintainer on this lesson, but I think you had previously been granted write access to the repository in your capacity as a LibraryCarpentry Curriculum Advisor.

For now, we are going to provide write access only to Maintainers---though that decision will be open to review, so please let us know (@ me or LibraryCarpentry/core-team-curriculum) if this interferes with the CAC's ability to perform their duties.

[jmjamison]

I'm ready for write access

[zkamvar]

@jmjamison access granted (though you did not include the exact phrase, I'm not going to be that much of a stickler)

[kaitlinnewson]

I am ready for write access :rocket:

[zkamvar]

@kaitlinnewson you now have write access!

[zkamvar]

Hi @annaoates, this is just a reminder that the lc-shell lesson transferred to The Workbench in May and you still need to confirm here that you followed the instructions in https://github.com/LibraryCarpentry/lc-shell/issues/226#issuecomment-1538545407 to regain write access to this repository.

[ErinBecker]

Hi @annaoates - You have not yet responded here to report that you completed the steps listed by @zkamvar above to regain your Maintainer access to this repository. The lesson infrastructure transition required a second Maintainer team to be temporarily created for all lessons, which can only be removed when all Maintainers have confirmed that they are ready to have their access restored. Maintenance of both teams is not sustainable for The Carpentries in the long run. At the beginning of November 2023 (note the deadline has been extended) we will remove access for Maintainers who have not taken the necessary action to continue working on the repository.

The Curriculum Team is truly grateful for everything you have already done as a Maintainer and we do not want to lose you! But we also understand that circumstances change and you may no longer have capacity to continue in your role. If you wish to retain your access and keep supporting the community, please follow the steps above then confirm that you are ready by commenting I am ready for write access 🚀 on this thread before the end of your day on Wednesday 1st November.

[ErinBecker]

Hi @annaoates - You no longer have Maintainer access to this repository. Please see the comment above for details. If you would like to restore your access, please re-clone the repository on your machine and then comment here with I am ready for write access 🚀 and the admin maintainer of this repository will restore your permissions. If you have any questions, please don’t hesitate to get in touch curriculum@carpentries.org

To the remaining Maintainers for this lesson - the Curriculum Team will be prioritizing onboarding of new Maintainers for lessons that have lost Maintainers in our next round of onboarding. Please don’t hesitate to reach out if your lesson needs additional support in the meantime - curriculum@carpentries.org.

I will close this issue now but will still be notified of any replies on the thread in future.