README

Workshop Documentation

This directory contains the full workshop curriculum: chapters, appendices, and supporting reference material.

Start here

• Course Guide -- map of every chapter and recommended reading order
• Get Going -- short on-ramp if you only have a few minutes
• Challenges -- the hands-on practice that goes with each chapter
• Student Onboarding -- first-time setup checklist

Core chapters

The numbered chapters (00 through 22) are the workshop curriculum, in order:

1. 00 -- Pre-workshop setup
2. 01 -- Choose your tools
3. 02 -- Understanding GitHub
4. 03 -- Navigating repositories
5. 04 -- The Learning Room
6. 05 -- Working with issues
7. 06 -- Working with pull requests
8. 07 -- Merge conflicts
9. 08 -- Open source culture
10. 09 -- Labels, milestones, projects
11. 10 -- Notifications and Day 1 close
12. 11 -- VS Code interface
13. 12 -- VS Code accessibility
14. 13 -- How Git works
15. 14 -- Git in practice
16. 15 -- Code review
17. 16 -- GitHub Copilot
18. 17 -- Issue templates
19. 18 -- Fork and contribute
20. 19 -- Accessibility agents
21. 20 -- Build your agent
22. 21 -- GitHub accessibility and open source
23. 22 -- What comes next

Appendices

Reference material that supports the chapters. See appendix-a-glossary.md for the full glossary and appendix-x-resources.md for external links and further reading.

Reference solutions

The solutions/ directory has reference answers for every challenge, intended for facilitator use and for learners who get stuck.