You are ready to teach

If you have worked through this handbook, you now have everything you need to run Git for Scientists.

You understand why the workshop is shaped the way it is: taught on a need-to-know basis, in a room that is safe to fail in, with collaboration at the center (2  Teaching philosophy). You know the journey runs from pre-course work through four hours of hands-on practice to a forward-looking wrap-up, and that learners pick up R and RStudio fluency, a first taste of Quarto, and reversibility as a habit as side benefits along the way (3  The shape of the course).

You have the setup in place: the accounts and software every learner and the instructor needs (Part 2), the three GitHub organizations and their repositories (8  Create the iteration organization), and a published cohort website (9  Build and publish the cohort website). You know how to run the day, from pre-flight checks (10  Before the day) to the timed run of show (11  Run of show).

And you know how to keep it going: spinning up the next cohort from the templates (12  Spin up the next cohort), and keeping the material a genuine Open Educational Resource through its license and citation (13  Keep it open and citable).

What is still to come

Two things in this handbook are deliberately open-ended, and they are yours to develop:

  • The record of each iteration. The four concept drawings are developed and in use (4  The concept drawings, Appendix B — The concept drawings at a glance); what stays open-ended is each cohort’s own record: the learner concept maps (photographed with consent, 11  Run of show), any drawings a cohort adds, and the parked-problem list. Capture them as photos and notes attached to issues in the iteration org (7  The three-organization model), so each cohort’s specifics and learnings live alongside that cohort’s material rather than getting lost.

  • The second part on task and project management (GitHub Projects, issues, and milestones) is planned as another four-hour workshop that builds directly on these foundations. It is not developed yet, and is expected to live under the same website repository template as this part. A further workshop on agentic coding for collaboration and scientific work sits on a longer horizon as a separate effort; this workshop is its prerequisite too.