GitHub for Maintainers

[tobyhodges]

Background

(Based on a conversation at OLS co-working, with @sgibson91.)

I recently finished drafting a skill-up for Carpentries lesson Maintainers that teaches:

• issue triage (labels, assignments)
• pull request reviews (line-by-line commenting, suggesting changes, "Request Changes" vs "Approve")
• resolving merge conflicts in the browser
• (plus ad-hoc discussion of Actions, Web Editor, milestones/project boards, ... that is not in the curriculum)

The source repository includes automation to create duplicate example repositories for people to use while following the skill-up.

Project Idea

We would like to create a "deCarpentriesified" version that would feel more authentic to people who maintain non-lesson repositories. This would involve:

• identifying/expanding list of skills to be taught
• designing an example repository
• defining authentic tasks to help teach the relevant skills and concepts
• creating branches, issue/pull request boilerplate, and workflow(s) to enable automated creation of example repositories for use during the skill-up

Who is this for?

The ideal project members would have experience in:

• GitHub, ideally as a project maintainer
• interacting with REST APIs

They would find motivation in:

• teaching new skills to people
• promoting inclusive practices in open source

[sayantikabanik]

Love the outline 😀

Few other ideas (happy to chime in, help co-create content/present)

• Introduction to project boards and effectively linking those to issues via automation
• Setting up pre-commit hooks
• Env management and more with GHA
• vale.sh intro, great addition for PR reviews