@@ -82,5 +82,5 @@ The Classroom model equivalents live in [learning-room/.github/workflows/](../le
 - [Workshop Deployment Guide](../classroom/README.md) -- full setup using GitHub Classroom
 - [Support Hub](https://github.com/Community-Access/support) -- post-workshop support and async Q&A
 - [Template Repository Content](../learning-room/.github/) -- automation that runs in each student's repo
-- [Student Guide](../learning-room/.github/STUDENT_GUIDE.md) -- how students interact with Gandalf bot
+- [Student Guide](https://github.com/Community-Access/git-going-with-github/blob/main/learning-room/.github/STUDENT_GUIDE.md) -- how students interact with Gandalf bot
 - [Challenge Progression Config](data/challenge-progression.json) -- level and badge definitions
@@ -125,7 +125,7 @@ Every content file must be reviewed before go-live. Use this checklist to assign
 
 - [ ] Root docs: [README.md](README.md), [BUILD.md](BUILD.md), [REGISTER.md](REGISTER.md), [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), [REPOSITORY_SECURITY.md](REPOSITORY_SECURITY.md).
 - [ ] Student onboarding: [docs/get-going.md](docs/get-going.md), [docs/course-guide.md](docs/course-guide.md), and [docs/student-onboarding.md](docs/student-onboarding.md).
-- [ ] Core chapters: [docs/00-pre-workshop-setup.md](docs/00-pre-workshop-setup.md) through [docs/21-next-steps.md](docs/21-next-steps.md).
+- [ ] Core chapters: [docs/00-pre-workshop-setup.md](docs/00-pre-workshop-setup.md) through [docs/22-what-comes-next.md](docs/22-what-comes-next.md).
 - [ ] Appendices: [docs/appendix-a-glossary.md](docs/appendix-a-glossary.md) through [docs/appendix-z-github-skills.md](docs/appendix-z-github-skills.md).
 - [ ] Challenge hub: [docs/CHALLENGES.md](docs/CHALLENGES.md).
 - [ ] Challenge solutions: all files in [docs/solutions](docs/solutions/README.md).
 
@@ -39,12 +39,12 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix L: Agents Reference](docs/appendix-l-agents-reference.md) - "All 80 agents organized by team"
-- ✅ [Appendix K: Copilot Reference](docs/appendix-k-copilot-reference.md) - "Platform features and MCP"
-- ✅ [Appendix M: Accessibility Standards](docs/appendix-m-accessibility-standards.md) - "WCAG 2.2 AA reference" (existing)
-- ✅ [Appendix AA: Installation & Setup](docs/appendix-aa-agent-installation-setup.md) - "Platform-specific installation guide (NEW)"
-- ✅ [Appendix AB: Advanced Patterns](docs/appendix-ab-advanced-agent-patterns.md) - "Subagents, hooks, skills (NEW)"
-- ✅ [Appendix AC: Document & Developer Tools](docs/appendix-ac-document-developer-tools.md) - "Specialized agents (NEW)"
+- ✅ [Appendix L: Agents Reference](../docs/appendix-l-agents-reference.md) - "All 80 agents organized by team"
+- ✅ [Appendix K: Copilot Reference](../docs/appendix-k-copilot-reference.md) - "Platform features and MCP"
+- ✅ [Appendix M: Accessibility Standards](../docs/appendix-m-accessibility-standards.md) - "WCAG 2.2 AA reference" (existing)
+- ✅ [Appendix AA: Installation & Setup](../docs/appendix-aa-agent-installation-setup.md) - "Platform-specific installation guide (NEW)"
+- ✅ [Appendix AB: Advanced Patterns](../docs/appendix-ab-advanced-agent-patterns.md) - "Subagents, hooks, skills (NEW)"
+- ✅ [Appendix AC: Document & Developer Tools](../docs/appendix-ac-document-developer-tools.md) - "Specialized agents (NEW)"
 - ✅ [admin/AGENTS_ROADMAP.md](admin/AGENTS_ROADMAP.md) - "Version history and learning pathways (NEW)"
 
 **Section 3A content includes:**
@@ -67,9 +67,9 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix L: Agents Reference](docs/appendix-l-agents-reference.md) - "Agent list and capabilities"
-- ✅ [Appendix AA: Installation & Setup](docs/appendix-aa-agent-installation-setup.md) - "Platform-specific setup"
-- ✅ [Chapter 19: Accessibility Agents](docs/19-accessibility-agents.md) - "Agent introduction"
+- ✅ [Appendix L: Agents Reference](../docs/appendix-l-agents-reference.md) - "Agent list and capabilities"
+- ✅ [Appendix AA: Installation & Setup](../docs/appendix-aa-agent-installation-setup.md) - "Platform-specific setup"
+- ✅ [Chapter 19: Accessibility Agents](../docs/19-accessibility-agents.md) - "Agent introduction"
 - ✅ [admin/AGENTS_ROADMAP.md](admin/AGENTS_ROADMAP.md) - "Version tracking"
 
 **New Section 4B (MCP Servers) includes:**
@@ -85,9 +85,9 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix K: Copilot Reference](docs/appendix-k-copilot-reference.md) - "Copilot features"
-- ✅ [Chapter 19: Accessibility Agents](docs/19-accessibility-agents.md) - "Agents introduction"
-- ✅ [Appendix AA: Installation & Setup](docs/appendix-aa-agent-installation-setup.md) - "Getting started"
+- ✅ [Appendix K: Copilot Reference](../docs/appendix-k-copilot-reference.md) - "Copilot features"
+- ✅ [Chapter 19: Accessibility Agents](../docs/19-accessibility-agents.md) - "Agents introduction"
+- ✅ [Appendix AA: Installation & Setup](../docs/appendix-aa-agent-installation-setup.md) - "Getting started"
 - ✅ [Accessibility Agents Repository](https://github.com/Community-Access/accessibility-agents) - "Canonical source for 80 agents"
 
 **Updated tables include:**
@@ -105,8 +105,8 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix L: Agents Reference](docs/appendix-l-agents-reference.md) - "All agents"
-- ✅ [Chapter 19: Accessibility Agents](docs/19-accessibility-agents.md) - "Agent overview"
+- ✅ [Appendix L: Agents Reference](../docs/appendix-l-agents-reference.md) - "All agents"
+- ✅ [Chapter 19: Accessibility Agents](../docs/19-accessibility-agents.md) - "Agent overview"
 - ✅ [Accessibility Agents Repository](https://github.com/Community-Access/accessibility-agents) - "Official source"
 
 **Platform-specific sections cover:**
@@ -130,9 +130,9 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix L: Agents Reference](docs/appendix-l-agents-reference.md) - "Agent list"
-- ✅ [Appendix AA: Installation & Setup](docs/appendix-aa-agent-installation-setup.md) - "Setup reference"
-- ✅ [Chapter 19: Accessibility Agents](docs/19-accessibility-agents.md) - "Agent context"
+- ✅ [Appendix L: Agents Reference](../docs/appendix-l-agents-reference.md) - "Agent list"
+- ✅ [Appendix AA: Installation & Setup](../docs/appendix-aa-agent-installation-setup.md) - "Setup reference"
+- ✅ [Chapter 19: Accessibility Agents](../docs/19-accessibility-agents.md) - "Agent context"
 - ✅ [Accessibility Agents Repository](https://github.com/Community-Access/accessibility-agents) - "Source for skills and hooks"
 
 **Advanced topics covered:**
@@ -151,9 +151,9 @@
 
 **Links OUT to:**
 
-- ✅ [Appendix L: Agents Reference](docs/appendix-l-agents-reference.md) - "Complete agent list"
-- ✅ [Appendix AB: Advanced Patterns](docs/appendix-ab-advanced-agent-patterns.md) - "Advanced techniques"
-- ✅ [Appendix AA: Installation & Setup](docs/appendix-aa-agent-installation-setup.md) - "Setup guide"
+- ✅ [Appendix L: Agents Reference](../docs/appendix-l-agents-reference.md) - "Complete agent list"
+- ✅ [Appendix AB: Advanced Patterns](../docs/appendix-ab-advanced-agent-patterns.md) - "Advanced techniques"
+- ✅ [Appendix AA: Installation & Setup](../docs/appendix-aa-agent-installation-setup.md) - "Setup guide"
 
 **Specialized content covers:**
 
@@ -173,7 +173,7 @@
 
 - ✅ Minimum versions table (VS Code 1.113+, Node.js v18+, Git v2.20+)
 - ✅ Version checking commands
-- ✅ Links to [Appendix AA: Installation](docs/appendix-aa-agent-installation-setup.md)
+- ✅ Links to [Appendix AA: Installation](../docs/appendix-aa-agent-installation-setup.md)
 - ✅ Explains agents are optional (Day 2 extension)
 
 ---
 
@@ -611,7 +611,7 @@ Everything you learned today is complete and self-contained. You can now:
 
 **What to do next on your own:**
 
-- Explore the [Next Steps](../docs/21-next-steps.md) guide for continuing your GitHub journey independently
+- Explore the [Next Steps](../docs/22-what-comes-next.md) guide for continuing your GitHub journey independently
 - Browse [github.com/topics/accessibility](https://github.com/topics/accessibility) for projects that need contributors
 - Look for issues labeled `good first issue` on any project that interests you
 - Complete the bonus challenges (A through E) in your Classroom repository
 
@@ -78,7 +78,7 @@
 
 ### Q: I am teaching GitHub to a group. Do I need to know everything?
 
-**A:** Yes, read the full curriculum first. Also read [FACILITATOR.md](FACILITATOR.md), [DAY1_AGENDA.md](DAY1_AGENDA.md), and [DAY2_AGENDA.md](DAY2_AGENDA.md) for lesson plans and pacing tips.
+**A:** Yes, read the full curriculum first. Also read [FACILITATOR.md](FACILITATOR_GUIDE.md), [DAY1_AGENDA.md](DAY1_AGENDA.md), and [DAY2_AGENDA.md](DAY2_AGENDA.md) for lesson plans and pacing tips.
 
 ### Q: I use screen readers (NVDA, JAWS, or VoiceOver). Is this guide accessible?
 
@@ -1018,7 +1018,7 @@ This FAQ does not cover your question? Try these resources in order:
 4. [**Appendix B (Screen Reader Cheat Sheet)**](../docs/appendix-b-screen-reader-cheatsheet.md) - NVDA, JAWS, VoiceOver keyboard commands
 5. [**Appendix U (Resources)**](../docs/appendix-x-resources.md) - External documentation and links
 6. **GitHub Issues** - Search existing issues or [open a new one](../../issues)
-7. [**FACILITATOR.md**](FACILITATOR.md) - If you are leading a workshop
+7. [**FACILITATOR.md**](FACILITATOR_GUIDE.md) - If you are leading a workshop
 
 *Last updated: May 2026*  
 *Have more questions? Open an issue or discussion on GitHub!*
 
@@ -40,7 +40,7 @@ Out of scope:
 | Registration entry page | [REGISTER.md](../REGISTER.md) |
 | Registration automation admin | [REGISTRATION-ADMIN.md](REGISTRATION-ADMIN.md) |
 | Registration automation quickstart | [REGISTRATION-QUICKSTART.md](REGISTRATION-QUICKSTART.md) |
-| Registration workflow logic | [.github/workflows/registration.yml](../.github/workflows/registration.yml) |
+| Registration workflow logic | [.github/workflows/registration.yml](https://github.com/Community-Access/git-going-with-github/blob/main/.github/workflows/registration.yml) |
 | Classroom deployment | [classroom/README.md](../classroom/README.md) |
 | Assignment copy and autograding setup | [admin/classroom/README.md](classroom/README.md) |
 | Human challenge walkthrough | [classroom/HUMAN_TEST_MATRIX.md](../classroom/HUMAN_TEST_MATRIX.md) |
@@ -542,7 +542,7 @@ Pass criteria:
 2. Confirm workflow marks the issue duplicate and closes it with guidance to the original issue.
 3. For waitlist behavior, use a controlled test strategy:
    - Preferred: run in a staging copy where capacity can be reached safely.
-   - Alternative: dry-run logic review from [.github/workflows/registration.yml](../.github/workflows/registration.yml) and verify conditions with maintainers.
+   - Alternative: dry-run logic review from [.github/workflows/registration.yml](https://github.com/Community-Access/git-going-with-github/blob/main/.github/workflows/registration.yml) and verify conditions with maintainers.
 4. Confirm waitlist message and `waitlist` label behavior in the chosen test environment.
 
 Pass criteria:
@@ -680,7 +680,7 @@ Note: a classroom already exists for this repository (`GIT Going with Github`, c
 1. Go to [classroom.github.com](https://classroom.github.com) as `accesswatch`.
 2. Select **New classroom** and choose `Community-Access-Classroom` as the organization.
 3. Name it `Git Going - [Cohort Name] - [Month Year]` (for example, `Git Going - May 2026`).
-4. Import roster from [classroom/roster-template.csv](../classroom/roster-template.csv) on the Roster tab.
+4. Import roster from [classroom/roster-template.csv](https://github.com/Community-Access/git-going-with-github/blob/main/classroom/roster-template.csv) on the Roster tab.
 5. Add `accesswatch-student` to the roster as the test student.
 
 **To verify the existing classroom is accessible:**
@@ -890,7 +890,7 @@ Core chapters:
 - [ ] [docs/18-fork-and-contribute.md](../docs/18-fork-and-contribute.md)
 - [ ] [docs/19-accessibility-agents.md](../docs/19-accessibility-agents.md)
 - [ ] [docs/20-build-your-agent.md](../docs/20-build-your-agent.md)
-- [ ] [docs/21-next-steps.md](../docs/21-next-steps.md)
+- [ ] [docs/22-what-comes-next.md](../docs/22-what-comes-next.md)
 
 Appendices:
 
@@ -954,10 +954,10 @@ Why this matters:
   - [ ] [classroom/HUMAN_TEST_MATRIX.md](../classroom/HUMAN_TEST_MATRIX.md)
   - [ ] [classroom/grading-guide.md](../classroom/grading-guide.md)
 - [ ] Learning Room automation docs:
-  - [ ] [learning-room/.github/STUDENT_GUIDE.md](../learning-room/.github/STUDENT_GUIDE.md)
-  - [ ] [learning-room/.github/FACILITATOR_GUIDE.md](../learning-room/.github/FACILITATOR_GUIDE.md)
-  - [ ] [learning-room/.github/SETUP_AND_MAINTENANCE.md](../learning-room/.github/SETUP_AND_MAINTENANCE.md)
-  - [ ] [learning-room/.github/DEPLOYMENT_VALIDATION.md](../learning-room/.github/DEPLOYMENT_VALIDATION.md)
+  - [ ] [learning-room/.github/STUDENT_GUIDE.md](https://github.com/Community-Access/git-going-with-github/blob/main/learning-room/.github/STUDENT_GUIDE.md)
+  - [ ] [learning-room/.github/FACILITATOR_GUIDE.md](https://github.com/Community-Access/git-going-with-github/blob/main/learning-room/.github/FACILITATOR_GUIDE.md)
+  - [ ] [learning-room/.github/SETUP_AND_MAINTENANCE.md](https://github.com/Community-Access/git-going-with-github/blob/main/learning-room/.github/SETUP_AND_MAINTENANCE.md)
+  - [ ] [learning-room/.github/DEPLOYMENT_VALIDATION.md](https://github.com/Community-Access/git-going-with-github/blob/main/learning-room/.github/DEPLOYMENT_VALIDATION.md)
 
 Pass criteria:
 
@@ -1243,7 +1243,7 @@ Why this matters:
 | `registration.yml` duplicate logic | Duplicate handling | Duplicate issue thread + labels + closed state | On second submission by same user | Duplicate message references original and issue auto-closes |
 | `registration.yml` waitlist logic | Capacity full behavior | Registration issue comment + `waitlist` label | When threshold reached in controlled test | Waitlist message and label applied |
 | `registration.yml` CSV export | Registration data artifact | Actions artifacts | Every registration run or manual dispatch | `registration-data` artifact is available and current |
-| `registration.yml` roster sync | Non-PII roster update | [.github/data/student-roster.json](../.github/data/student-roster.json) and workflow commit | Every registration run or manual dispatch | Roster updates only when changed and no PII stored |
+| `registration.yml` roster sync | Non-PII roster update | [.github/data/student-roster.json](https://github.com/Community-Access/git-going-with-github/blob/main/.github/data/student-roster.json) and workflow commit | Every registration run or manual dispatch | Roster updates only when changed and no PII stored |
 | `pr-validation-bot.yml` | PR structure and guidance checks | PR comments + Actions | PR open/edit/sync/review events | Validation comment appears and updates in place |
 | `content-validation.yml` | Link/markdown/accessibility checks | PR checks/comments + Actions logs | PR open/edit/sync | Clear actionable findings tied to changed files |
 | `student-progression.yml` | Challenge unlock sequence | Issues tab + Actions logs | Issue close and workflow dispatch | Next challenge issue appears with correct sequence |
 
@@ -92,7 +92,7 @@ Routing:
 
 - [ ] `REGISTER.md` and registration workflow comments point to Support Hub.
 - [ ] Facilitator guides reference Support Hub as the alumni channel.
-- [ ] `docs/21-next-steps.md` points learners to Support Hub.
+- [ ] `docs/22-what-comes-next.md` points learners to Support Hub.
 - [ ] Go-live checklist includes Support Hub readiness.
 - [ ] Podcast scripts/transcripts reference Support Hub as the default help path.
 
 
@@ -49,7 +49,7 @@
 - **Windows:** Git may not be in your PATH. Search for "Git Bash" in the Start menu and use that terminal instead. Or add Git to PATH: Settings → System → Advanced → Environment Variables → edit PATH → add `C:\Program Files\Git\cmd`
 - **macOS:** If `xcode-select` hangs, try `sudo xcode-select --reset` first
 
-**Prevention:** Complete [Pre-Workshop Setup](docs/00-pre-workshop-setup.md) before starting.
+**Prevention:** Complete [Pre-Workshop Setup](../docs/00-pre-workshop-setup.md) before starting.
 
 ### Problem: Node.js or npm is not installed
 
@@ -109,7 +109,7 @@ Security: We strongly recommend enabling Two-Factor Authentication (2FA) on your
 **Solution:**
 
 - **Corporate/restricted device:** Ask your IT department to allow VS Code, or use the portable ZIP version: <https://code.visualstudio.com/docs/editor/portable>
-- **Chromebook:** Use github.dev (press `.` on any repo) for Day 1. For Day 2, consider GitHub Codespaces: see [Appendix N](docs/appendix-j-cloud-editors.md)
+- **Chromebook:** Use github.dev (press `.` on any repo) for Day 1. For Day 2, consider GitHub Codespaces: see [Appendix N](../docs/appendix-j-cloud-editors.md)
 - **Older OS:** VS Code requires Windows 10+, macOS 10.15+, or a modern Linux distribution
 
 ## Git Configuration and Operations
@@ -248,7 +248,7 @@ Use the same email address as your GitHub account so commits are attributed to y
 2. Check tokens: <https://github.com/settings/tokens> - is your token still active?
 3. Regenerate if expired
 
-See [Appendix D (Git Authentication)](docs/appendix-d-git-authentication.md) for complete setup instructions.
+See [Appendix D (Git Authentication)](../docs/appendix-d-git-authentication.md) for complete setup instructions.
 
 ### Problem: SSH key passphrase prompts every time
 
@@ -312,7 +312,7 @@ See [Appendix D (Git Authentication)](docs/appendix-d-git-authentication.md) for
 1. Go to <https://github.com/settings/accessibility>
 2. Uncheck "Hovercards" (or the equivalent setting for reducing motion/overlays)
 3. Save changes
-4. This is covered in [Pre-Workshop Setup](docs/00-pre-workshop-setup.md), Step 4
+4. This is covered in [Pre-Workshop Setup](../docs/00-pre-workshop-setup.md), Step 4
 
 ### Problem: GitHub shows "Loading..." or blank content
 
@@ -480,7 +480,7 @@ git checkout -b recovered-branch COMMIT-HASH
 
 **Cause D: Branch protection rules**
 
-- The main branch may have protection rules. See [Appendix K (Branch Protection)](docs/appendix-o-branch-protection.md)
+- The main branch may have protection rules. See [Appendix K (Branch Protection)](../docs/appendix-o-branch-protection.md)
 
 ### Problem: PR shows wrong base branch
 
@@ -629,7 +629,7 @@ After fixing, commit and push to main, then hard-refresh the browser.
 - **Too quiet:** Check that `editor.accessibilitySupport` is set to `on` (not `auto` or `off`)
 - **Audio signals:** Search `accessibility.signals` in Settings → enable or disable specific sounds (error, warning, breakpoint, diff changes, etc.)
 
-See [Appendix M (VS Code Accessibility Reference)](docs/appendix-g-vscode-reference.md) for all settings.
+See [Appendix M (VS Code Accessibility Reference)](../docs/appendix-g-vscode-reference.md) for all settings.
 
 ### Problem: Cannot find a VS Code command
 
@@ -1147,7 +1147,7 @@ See [Appendix M (VS Code Accessibility Reference)](docs/appendix-g-vscode-refere
 
 **Symptoms:** You want to read the materials but cannot find where they are hosted or how to download them.
 
-**Solution:** See [Appendix Y (Accessing Workshop Materials)](docs/appendix-y-workshop-materials.md) for complete instructions covering:
+**Solution:** See [Appendix Y (Accessing Workshop Materials)](../docs/appendix-y-workshop-materials.md) for complete instructions covering:
 
 - Reading on GitHub Pages (if hosted)
 - Reading directly on GitHub.com
@@ -1198,9 +1198,9 @@ If your issue is not listed here:
 
 1. **[FAQ](FAQ.md)** - Answers to common questions about the workshop
 2. **[Quick Reference](QUICK_REFERENCE.md)** - Condensed keyboard shortcuts and commands
-3. **[Glossary](docs/appendix-a-glossary.md)** - Term definitions
-4. **[Screen Reader Cheat Sheet](docs/appendix-b-screen-reader-cheatsheet.md)** - NVDA, JAWS, VoiceOver commands
-5. **[Resources](docs/appendix-x-resources.md)** - External documentation and links
+3. **[Glossary](../docs/appendix-a-glossary.md)** - Term definitions
+4. **[Screen Reader Cheat Sheet](../docs/appendix-b-screen-reader-cheatsheet.md)** - NVDA, JAWS, VoiceOver commands
+5. **[Resources](../docs/appendix-x-resources.md)** - External documentation and links
 6. **Open an issue** on this repository with:
    - What you tried
    - What happened (exact error messages)