Skip to content

Commit 79533ce

Browse files
author
GitHub Workshop Bot
committed
docs: complete chapter restructuring cross-reference updates
New Chapter 5 (VS Code Accessibility) created with 18 sections, 1752 lines. Chapters 5-9 renumbered to 6-10; old Chapter 10 absorbed into new Chapter 5. Cross-reference updates across 68 files: - All chapter docs: internal chapter numbers and navigation links - README.md: curriculum table and directory tree restructured - Podcast bundles: 24 filename refs + chapter number updates - Exercise tables reordered in PROGRESS_TRACKER, course-guide, ep00-welcome - CHALLENGE_SYSTEM_ARCHITECTURE: table renumbered, script refs, compound ranges - COMPREHENSIVE_VALIDATION_AUDIT: VS Code Basics to VS Code Accessibility - GITHUB_PROPOSAL: Part 1/Part 2 tables and Day 1/Day 2 boundaries - FACILITATOR, FAQ, LEARNING_PATHS, CHALLENGES: compound range refs - GROUP_CHALLENGES: participant assignment ranges - learning-room submodule: CHALLENGES, GROUP_CHALLENGES, LEARNING_PATHS synced - Removed stale duplicate files from git mv operations
1 parent ab2f926 commit 79533ce

File tree

68 files changed

+2327
-1217
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

68 files changed

+2327
-1217
lines changed

.github/internal/CHAPTER_PROGRESSION_ANALYSIS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -362,8 +362,8 @@ Optional post-workshop:
362362
## Verification: Is This Truly Progressive?
363363

364364
### Criterion 1: Foundation Before Complexity
365-
- **PASS** - Chapters 00-02a establish context; chapters 03-05 teach basic mechanics
366-
- **PASS** - Chapters 06-09 assume all prior skills understood
365+
- **PASS** - Chapters 00-02a establish context; chapters 03-06 teach basic mechanics
366+
- **PASS** - Chapters 07-10 assume all prior skills understood
367367
- **PASS** - Chapter 10 explicitly marks transition
368368

369369
### Criterion 2: Prerequisites Met

ANNOUNCEMENT.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -86,9 +86,9 @@ Your screen reader and keyboard are the only tools you need. Everything happens
8686
| **[Screen Reader Orientation to GitHub](https://community-access.org/git-going-with-github/docs/01-understanding-github-web-structure.html)** | Navigate GitHub pages using headings, landmarks, and keyboard shortcuts |
8787
| **[Navigating Repositories](https://community-access.org/git-going-with-github/docs/02-navigating-repositories.html)** | Explore a real repository - files, branches, commits, contributors |
8888
| **[Working with Issues](https://community-access.org/git-going-with-github/docs/04-working-with-issues.html)** | Search, file, comment on, and triage issues using [Markdown](https://community-access.org/git-going-with-github/docs/appendix-e-github-flavored-markdown.html) |
89-
| **[Understanding Pull Requests](https://community-access.org/git-going-with-github/docs/05-working-with-pull-requests.html)** | Read diffs, write inline review comments, approve and merge |
90-
| **[Your First Contribution Sprint](https://community-access.org/git-going-with-github/docs/06-merge-conflicts.html)** | Make a real contribution to the shared practice repository - with automated bot feedback and human peer review |
91-
| **[Community and Culture](https://community-access.org/git-going-with-github/docs/07-culture-etiquette.html)** | Open source etiquette, constructive feedback, [managing notifications](https://community-access.org/git-going-with-github/docs/09-notifications.html), organizing with [labels](https://community-access.org/git-going-with-github/docs/08-labels-milestones-projects.html) |
89+
| **[Understanding Pull Requests](https://community-access.org/git-going-with-github/docs/06-working-with-pull-requests.html)** | Read diffs, write inline review comments, approve and merge |
90+
| **[Your First Contribution Sprint](https://community-access.org/git-going-with-github/docs/07-merge-conflicts.html)** | Make a real contribution to the shared practice repository - with automated bot feedback and human peer review |
91+
| **[Community and Culture](https://community-access.org/git-going-with-github/docs/08-culture-etiquette.html)** | Open source etiquette, constructive feedback, [managing notifications](https://community-access.org/git-going-with-github/docs/10-notifications.html), organizing with [labels](https://community-access.org/git-going-with-github/docs/09-labels-milestones-projects.html) |
9292

9393
You will also work through [GitHub Skills](https://skills.github.com/) modules - interactive, bot-guided courses that run in your own GitHub account. A bot named Mona creates real issues and pull requests for you, verifies your actions, and guides you through each step. It is the same mechanism used by real open source projects.
9494

@@ -99,7 +99,7 @@ You earned the tools. Now you wield them.
9999
| Block | What Happens |
100100
|-------|-------------|
101101
| **Day 1 Debrief** | Celebrate what shipped, surface questions, set your Day 2 goal |
102-
| **[VS Code Setup](https://community-access.org/git-going-with-github/docs/10-vscode-basics.html)** | Screen reader mode, workspace navigation, the bridge from browser to editor |
102+
| **[VS Code Setup](https://community-access.org/git-going-with-github/docs/05-vscode-accessibility.html)** | Screen reader mode, workspace navigation, the bridge from browser to editor |
103103
| **[Deep Contribution with Copilot](https://community-access.org/git-going-with-github/docs/13-github-copilot.html)** | Use [GitHub Copilot](https://github.com/features/copilot) as a writing partner - draft improvements, review your own work, commit with confidence |
104104
| **[Activate the Agents](https://community-access.org/git-going-with-github/docs/16-accessibility-agents.html)** | Explore 55 AI agents across 3 teams that amplify every skill you built on Day 1 - daily briefings, issue triage, PR review, accessibility monitoring |
105105
| **[Ship Your Contribution](https://community-access.org/git-going-with-github/docs/14-accessible-code-review.html)** | Open a real pull request to a live public repository. Your facilitator reviews and merges it. |

BUILD.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The build is run **locally** before committing. There is no CI pipeline - you bu
3434
**Typical workflow:**
3535
1. Edit one or more `.md` files
3636
2. Run `npm run build:html`
37-
3. Stage and commit everything: `git add -A && git commit -m "docs: update chapter 5 and rebuild HTML"`
37+
3. Stage and commit everything: `git add -A && git commit -m "docs: update chapter 6 and rebuild HTML"`
3838
4. Push
3939

4040
### What Gets Converted

CHALLENGE_SYSTEM_ARCHITECTURE.md

Lines changed: 35 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -29,17 +29,17 @@ This document summarizes the complete challenge system architecture built for th
2929

3030
### 2. Challenge Templates (Issue Infrastructure)
3131

32-
Located in `.github/ISSUE_TEMPLATE/` (Chapters 4-6, 11) and inline in `scripts/create_all_challenges.ps1` (Chapters 7-16):
32+
Located in `.github/ISSUE_TEMPLATE/` (Chapters 4, 6, 11) and inline in `scripts/create_all_challenges.ps1` (Chapters 5, 8-10, 12-16):
3333

3434
| Chapter | Challenges | Submission | Bot Validated | Skill | Day | Status |
3535
|---------|-----------|------------|---------------|-------|-----|--------|
3636
| **04** Issues | 3 | Issue comment (evidence links) | No (manual) | github-issues | 1 | Created |
37-
| **05** Pull Requests | 3 | PR with `Closes #XX` | Yes | pull-requests | 1 | Created |
38-
| **06** Merge Conflicts | 1 | PR with `Closes #XX` | Yes | merge-conflicts | 1 | Created |
39-
| **07** Culture and Etiquette | 1 | Issue comment | No | collaboration | 1 | Created |
40-
| **08** Labels, Milestones, Projects | 1 | Issue comment | No | triage | 1 | Created |
41-
| **09** Notifications | 1 | Issue comment | No | notifications | 1 | Created |
42-
| **10** VS Code Basics | 1 | Issue comment | No | vs-code | 2 | Created |
37+
| **05** VS Code Accessibility | 1 | Issue comment | No | vs-code | 1 | Created |
38+
| **06** Pull Requests | 3 | PR with `Closes #XX` | Yes | pull-requests | 1 | Created |
39+
| **07** Merge Conflicts | 1 | PR with `Closes #XX` | Yes | merge-conflicts | 1 | Created |
40+
| **08** Culture and Etiquette | 1 | Issue comment | No | collaboration | 1 | Created |
41+
| **09** Labels, Milestones, Projects | 1 | Issue comment | No | triage | 1 | Created |
42+
| **10** Notifications | 1 | Issue comment | No | notifications | 1 | Created |
4343
| **11** Git Source Control | 3 | PR with `Closes #XX` | Yes | git-source-control | 2 | Created |
4444
| **12** PR Extension | 2 | Issue comment | No | pr-extension | 2 | Created |
4545
| **13** GitHub Copilot | 3 | Issue comment | No | copilot | 2 | Created |
@@ -49,7 +49,7 @@ Located in `.github/ISSUE_TEMPLATE/` (Chapters 4-6, 11) and inline in `scripts/c
4949

5050
**Total: 26 challenges per student**
5151

52-
Chapters 5, 6, and 11 use PR-based submission with `Closes #XX` syntax. Chapter 4 uses issue-comment-based submission where students post evidence links on their assigned challenge issue (no branch or file editing required). All other chapters use issue-comment-based submission where students post evidence as a checklist comment.
52+
Chapters 6, 7, and 11 use PR-based submission with `Closes #XX` syntax. Chapter 4 uses issue-comment-based submission where students post evidence links on their assigned challenge issue (no branch or file editing required). All other chapters use issue-comment-based submission where students post evidence as a checklist comment.
5353

5454
**Template Contents:**
5555
- YAML frontmatter with placeholders: `{CHAPTER}`, `{CHALLENGE_NUM}`, `{CHALLENGE_TITLE}`, `{USERNAME}`, `{ISSUE_NUMBER}`
@@ -72,8 +72,8 @@ assignees: ["{USERNAME}"]
7272
7373
| Script | Purpose | Chapters |
7474
|--------|---------|----------|
75-
| `scripts/create_student_issues.ps1` | Original 10 challenges (template-based) | 04, 05, 06, 11 |
76-
| `scripts/create_all_challenges.ps1` | All 26 challenges (self-contained) | 07-10, 12-16 |
75+
| `scripts/create_student_issues.ps1` | Original 10 challenges (template-based) | 04, 06, 07, 11 |
76+
| `scripts/create_all_challenges.ps1` | All 26 challenges (self-contained) | 05, 08-10, 12-16 |
7777

7878
#### Primary Script: `create_all_challenges.ps1`
7979

@@ -86,11 +86,11 @@ assignees: ["{USERNAME}"]
8686
.\scripts\create_all_challenges.ps1
8787
8888
# Create only specific chapters (e.g., just the new ones)
89-
.\scripts\create_all_challenges.ps1 -ChaptersOnly "07,08,09,10,12,13,14,15,16"
89+
.\scripts\create_all_challenges.ps1 -ChaptersOnly "05,08,09,10,12,13,14,15,16"
9090
```
9191

9292
**What It Does:**
93-
1. Defines all 16 challenge templates inline (Chapters 7-16, 16 challenges)
93+
1. Defines all 16 challenge templates inline (Chapters 5, 8-10, 12-16; 16 challenges)
9494
2. Loads org members via `gh api`
9595
3. Checks all existing open challenge issues (paginated)
9696
4. Compares each student's existing issues against the full template set
@@ -103,7 +103,7 @@ The script is designed to be rerun periodically. It only creates issues for chal
103103

104104
#### Legacy Script: `create_student_issues.ps1`
105105

106-
Creates the original 10 challenges (Ch 04, 05, 06, 11) by cloning from Weijun-Zhang-1996's template issues. Still functional but superseded by `create_all_challenges.ps1` for new chapters.
106+
Creates the original 10 challenges (Ch 04, 06, 07, 11) by cloning from Weijun-Zhang-1996's template issues. Still functional but superseded by `create_all_challenges.ps1` for new chapters.
107107

108108
**Prerequisites for Both Scripts:**
109109
- GitHub CLI (`gh`) installed and authenticated
@@ -114,8 +114,8 @@ Creates the original 10 challenges (Ch 04, 05, 06, 11) by cloning from Weijun-Zh
114114

115115
**Applicable Chapters:**
116116
- Chapter 4: Working with Issues (issue evidence + quality validation)
117-
- Chapter 5: Pull Requests (PR workflow validation)
118-
- Chapter 6: Merge Conflicts (conflict resolution validation)
117+
- Chapter 6: Pull Requests (PR workflow validation)
118+
- Chapter 7: Merge Conflicts (conflict resolution validation)
119119
- Chapter 11: Git & Source Control (Git operations validation)
120120

121121
**How It Works:**
@@ -183,7 +183,7 @@ Chapter numbers are zero-padded to two digits (04, 05, 06, 07... 16) so issues s
183183
**Example:**
184184
```
185185
Chapter 04.1: Create Your First Issue (@accesswatch)
186-
Chapter 05.2: Open Your First Pull Request (@amandarush)
186+
Chapter 6.2: Open Your First Pull Request (@amandarush)
187187
Chapter 11.3: Push to GitHub (@andysq62)
188188
Chapter 13.2: Ask Copilot to Explain a Repo (@apelli95)
189189
```
@@ -219,7 +219,7 @@ gh issue list --label "challenge: intermediate" --state open
219219

220220
### Lifecycle States
221221

222-
Each challenge issue transitions through states. PR-based challenges (Ch 04, 05, 06, 11) auto-close when a PR merges. Comment-based challenges (Ch 07-10, 12-16) are closed manually by the student or facilitator after evidence is posted.
222+
Each challenge issue transitions through states. PR-based challenges (Ch 04, 05, 06, 11) auto-close when a PR merges. Comment-based challenges (Ch 8-10, 12-16) are closed manually by the student or facilitator after evidence is posted.
223223

224224
| State | Condition | PR-Based | Comment-Based |
225225
|-------|-----------|----------|---------------|
@@ -261,7 +261,7 @@ Each challenge issue transitions through states. PR-based challenges (Ch 04, 05,
261261
- **Relevance:** Does each challenge teach intended concept?
262262
- Check: Students successfully demonstrate skill in PR
263263
- **Pacing:** Are challenges completable in allotted time?
264-
- Check: 80%+ of students reach Chapter 6 on Day 1
264+
- Check: 80%+ of students reach Chapter 7 on Day 1
265265
- **Motivation:** Do students attempt optional challenges (not required)?
266266
- Check: Any student attempts Chapters 12-16 (guided, not automated)
267267

@@ -273,8 +273,8 @@ Each challenge issue transitions through states. PR-based challenges (Ch 04, 05,
273273
├── .github/
274274
│ ├── ISSUE_TEMPLATE/
275275
│ │ ├── challenge-chapter-4.md <- Issue template (Chapter 4)
276-
│ │ ├── challenge-chapter-5.md <- Issue template (Chapter 5)
277-
│ │ ├── challenge-chapter-6.md <- Issue template (Chapter 6)
276+
│ │ ├── challenge-chapter-5.md <- Issue template (Chapter 6)
277+
│ │ ├── challenge-chapter-6.md <- Issue template (Chapter 7)
278278
│ │ ├── challenge-chapter-11.md <- Issue template (Chapter 11)
279279
│ │ └── challenge-hub.md <- Generic template with placeholders
280280
│ ├── data/
@@ -287,20 +287,20 @@ Each challenge issue transitions through states. PR-based challenges (Ch 04, 05,
287287
288288
├── scripts/
289289
│ ├── create_student_issues.ps1 <- Original 10-challenge creator (Ch 04/05/06/11)
290-
│ └── create_all_challenges.ps1 <- Full 26-challenge creator (Ch 07-16)
290+
│ └── create_all_challenges.ps1 <- Full 26-challenge creator (Ch 8-16)
291291
292292
├── learning-room/
293293
│ └── docs/
294294
│ └── CHALLENGES.md <- Challenge Hub (student reference)
295295
296296
├── docs/
297297
│ ├── 04-working-with-issues.md
298-
│ ├── 05-working-with-pull-requests.md
299-
│ ├── 06-merge-conflicts.md
300-
│ ├── 07-culture-etiquette.md
301-
│ ├── 08-labels-milestones-projects.md
302-
│ ├── 09-notifications.md
303-
│ ├── 10-vscode-basics.md
298+
│ ├── 06-working-with-pull-requests.md
299+
│ ├── 07-merge-conflicts.md
300+
│ ├── 08-culture-etiquette.md
301+
│ ├── 09-labels-milestones-projects.md
302+
│ ├── 10-notifications.md
303+
│ ├── 05-vscode-accessibility.md
304304
│ ├── 11-git-source-control.md
305305
│ ├── 12-github-pull-requests-extension.md
306306
│ ├── 13-github-copilot.md
@@ -320,12 +320,12 @@ Each challenge issue transitions through states. PR-based challenges (Ch 04, 05,
320320

321321
### From Student Docs
322322
- [docs/04-working-with-issues.md](docs/04-working-with-issues.md) - links to Chapter 4 challenges
323-
- [docs/05-working-with-pull-requests.md](docs/05-working-with-pull-requests.md) - links to Chapter 5 challenges
324-
- [docs/06-merge-conflicts.md](docs/06-merge-conflicts.md) - links to Chapter 6 challenges
325-
- [docs/07-culture-etiquette.md](docs/07-culture-etiquette.md) - links to Chapter 7 challenges
326-
- [docs/08-labels-milestones-projects.md](docs/08-labels-milestones-projects.md) - links to Chapter 8 challenges
327-
- [docs/09-notifications.md](docs/09-notifications.md) - links to Chapter 9 challenges
328-
- [docs/10-vscode-basics.md](docs/10-vscode-basics.md) - links to Chapter 10 challenges
323+
- [docs/06-working-with-pull-requests.md](docs/06-working-with-pull-requests.md) - links to Chapter 6 challenges
324+
- [docs/07-merge-conflicts.md](docs/07-merge-conflicts.md) - links to Chapter 7 challenges
325+
- [docs/08-culture-etiquette.md](docs/08-culture-etiquette.md) - links to Chapter 8 challenges
326+
- [docs/09-labels-milestones-projects.md](docs/09-labels-milestones-projects.md) - links to Chapter 9 challenges
327+
- [docs/10-notifications.md](docs/10-notifications.md) - links to Chapter 10 challenges
328+
- [docs/05-vscode-accessibility.md](docs/05-vscode-accessibility.md) - links to Chapter 5 challenges
329329
- [docs/11-git-source-control.md](docs/11-git-source-control.md) - links to Chapter 11 challenges
330330
- [docs/12-github-pull-requests-extension.md](docs/12-github-pull-requests-extension.md) - links to Chapter 12 challenges
331331
- [docs/13-github-copilot.md](docs/13-github-copilot.md) - links to Chapter 13 challenges
@@ -368,8 +368,8 @@ Chapter {X}.{Y}: {Challenge_Title} (@{USERNAME})
368368
**Valid Examples:**
369369
```
370370
Chapter 04.1: Create Your First Issue (@accesswatch)
371-
Chapter 05.2: Review and Approve a Pull Request (@amandarush)
372-
Chapter 06.1: Resolve a Merge Conflict (@andysq62)
371+
Chapter 6.2: Review and Approve a Pull Request (@amandarush)
372+
Chapter 7.1: Resolve a Merge Conflict (@andysq62)
373373
Chapter 11.3: Push Your Work to GitHub (@apelli95)
374374
Chapter 14.1: Review a PR with Inline Comments (@JeffBlumentworker)
375375
Chapter 16.3: Agent Instructions Deep Dive (@ChrisDuffley)

0 commit comments

Comments
 (0)