Skip to content

Commit f97ed1d

Browse files
committed
Merge remote-tracking branch 'origin/main' into wicky
# Conflicts: # docs/02-navigating-repositories.md # docs/03-the-learning-room.md # docs/12-github-pull-requests-extension.md # docs/15-issue-templates.md # docs/appendix-i-github-projects.md # docs/appendix-m-vscode-accessibility-reference.md # docs/appendix-q-github-actions-workflows.md
2 parents 11269a2 + 171ad98 commit f97ed1d

9 files changed

Lines changed: 376 additions & 183 deletions

.github/workflows/sync-docs-to-wiki.yml

Lines changed: 0 additions & 37 deletions
This file was deleted.

CHALLENGE_SYSTEM_ARCHITECTURE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Located in `.github/ISSUE_TEMPLATE/` (Chapters 4-6, 11) and inline in `scripts/c
3333

3434
| Chapter | Challenges | Submission | Bot Validated | Skill | Day | Status |
3535
|---------|-----------|------------|---------------|-------|-----|--------|
36-
| **04** Issues | 3 | PR with `Closes #XX` | No (manual) | github-issues | 1 | Created |
36+
| **04** Issues | 3 | Issue comment (evidence links) | No (manual) | github-issues | 1 | Created |
3737
| **05** Pull Requests | 3 | PR with `Closes #XX` | Yes | pull-requests | 1 | Created |
3838
| **06** Merge Conflicts | 1 | PR with `Closes #XX` | Yes | merge-conflicts | 1 | Created |
3939
| **07** Culture and Etiquette | 1 | Issue comment | No | collaboration | 1 | 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 4, 5, 6, and 11 use PR-based submission with `Closes #XX` syntax. All other chapters use issue-comment-based submission where students post evidence as a checklist comment.
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.
5353

5454
**Template Contents:**
5555
- YAML frontmatter with placeholders: `{CHAPTER}`, `{CHALLENGE_NUM}`, `{CHALLENGE_TITLE}`, `{USERNAME}`, `{ISSUE_NUMBER}`

README.md

Lines changed: 89 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -208,104 +208,95 @@ The Facilitator guide includes templates, scripts, success metrics, and a final
208208

209209
> **One repository, everything included.** Clone or fork this repo and you have the complete workshop - all curriculum guides, Accessibility Agents agents and slash commands, YAML issue forms, PR template, and a practice contribution target in `learning-room/`. GitHub Skills modules cannot be bundled here (each participant activates their own copy on their own account), but links are in `.github/ISSUE_TEMPLATE/config.yml`.
210210
211-
**Root files:**
212-
213-
- README.md -- You are here
214-
- CONTRIBUTING.md -- How to contribute to this repo
215-
- CODE_OF_CONDUCT.md -- Community standards
216-
- FACILITATOR.md -- For workshop organizers only
217-
- DAY1_AGENDA.md -- Day 1 workshop schedule (facilitators only)
218-
- DAY2_AGENDA.md -- Day 2 workshop schedule (facilitators only)
219-
- .gitignore
220-
221-
**.github/ folder:**
222-
223-
- ISSUE_TEMPLATE/
224-
- config.yml -- Links to GitHub Skills; disables blank issues
225-
- accessibility-bug.yml -- Structured accessibility bug form (YAML)
226-
- feature-request.yml -- Feature/improvement request form (YAML)
227-
- PULL_REQUEST_TEMPLATE.md -- PR checklist with accessibility section
228-
- agents/ -- Accessibility Agents: workshop Copilot Chat agents (55 total across 3 teams)
229-
- daily-briefing.agent.md
230-
- issue-tracker.agent.md
231-
- pr-review.agent.md
232-
- analytics.agent.md
233-
- insiders-a11y-tracker.agent.md
234-
- template-builder.agent.md
235-
- preferences.example.md -- Copy to preferences.md and personalize
236-
- prompts/ -- 54+ slash commands for Copilot Chat
237-
- a11y-update.prompt.md
238-
- create-issue.prompt.md
239-
- daily-briefing.prompt.md
240-
- review-pr.prompt.md
241-
- triage.prompt.md
242-
- ... (23 more - see appendix-v-accessibility-agents-reference.md)
243-
244-
**learning-room/ folder:** Practice target for the contribution sprint
245-
246-
- README.md
247-
- docs/
248-
- welcome.md -- Has TODO sections for you to complete
249-
- keyboard-shortcuts.md -- Has intentional accessibility issues to find and fix
250-
- setup-guide.md -- Has a broken link to find and fix
251-
252-
**podcasts/ folder:** Podcast production pipeline
253-
254-
- PODCASTS.md -- Audio player page (44 episodes, HTML5 audio)
255-
- podcasts/
256-
- build-bundles.js -- Generates NotebookLM source bundles
257-
- generate-site.js -- Generates PODCASTS.md and RSS feed from manifest
258-
- manifest.json -- Episode manifest (status, metadata)
259-
- feed.xml -- RSS 2.0 podcast feed
260-
- README.md -- Production guide
261-
- bundles/ -- 44 generated episode source bundles
262-
263-
**docs/ folder:** Full workshop curriculum (17 lessons + 26 appendices A-Z)
264-
265-
- course-guide.md -- Student landing page: day-by-day overview, exercises, help
266-
- 00-pre-workshop-setup.md
267-
- 01-understanding-github-web-structure.md -- How GitHub is organized (start here)
268-
- 02-navigating-repositories.md -- Accessibility Agents: @daily-briefing
269-
- 03-the-learning-room.md -- Read this early: your shared space and PR workflow
270-
- 04-working-with-issues.md -- Accessibility Agents: @issue-tracker
271-
- 05-working-with-pull-requests.md -- Accessibility Agents: @pr-review
272-
- 06-merge-conflicts.md -- Accessibility Agents: Copilot conflict prevention
273-
- 07-culture-etiquette.md -- Accessibility Agents: output responsibility
274-
- 08-labels-milestones-projects.md -- Accessibility Agents: @issue-tracker + labels
275-
- 09-notifications.md -- Accessibility Agents: @daily-briefing + inbox
276-
- 10-vscode-basics.md -- VS Code setup, github.dev, screen reader mode, accessibility basics
277-
- 11-git-source-control.md -- Git operations in VS Code: clone, branch, commit, merge, stash
278-
- 12-github-pull-requests-extension.md -- GitHub PR extension: view, review, create, merge PRs
279-
- 13-github-copilot.md -- GitHub Copilot: inline suggestions, Chat, prompting, custom agents
280-
- 14-accessible-code-review.md -- Reviewer mechanics: diffs, comments, Accessible Diff Viewer
281-
- 15-issue-templates.md -- Creating GitHub issue templates
282-
- 16-accessibility-agents.md -- Accessibility Agents: 55 agents, 3 teams, 5 platforms
283-
- appendix-a-glossary.md -- A: Every term explained (look up any time)
284-
- appendix-b-screen-reader-cheatsheet.md -- B: Full shortcut reference, per-screen-reader tables
285-
- appendix-c-accessibility-standards.md -- C: WCAG 2.2, ARIA, PR checklist
286-
- appendix-d-git-authentication.md -- D: SSH keys, PATs, credential storage
287-
- appendix-e-github-flavored-markdown.md -- E: Alert blocks, Mermaid, math, footnotes, heading anchors
288-
- appendix-f-github-gists.md -- F: Code snippets, sharing, embedding
289-
- appendix-g-github-discussions.md -- G: GitHub Discussions navigation and participation
290-
- appendix-h-releases-tags-insights.md -- H: Releases, tags, version numbers, pulse, contributors, traffic
291-
- appendix-i-github-projects.md -- I: GitHub Projects deep dive (boards, tables, roadmaps, automations)
292-
- appendix-j-advanced-search.md -- J: Search query language reference
293-
- appendix-k-branch-protection-rulesets.md -- K: Branch rules, rulesets, diagnosing blocked PRs
294-
- appendix-l-github-security-features.md -- L: Dependabot, secret scanning, code scanning, private advisories
295-
- appendix-m-vscode-accessibility-reference.md -- M: Complete VS Code accessibility technical reference
296-
- appendix-n-github-codespaces.md -- N: Cloud dev environments, accessibility setup, screen reader usage
297-
- appendix-o-github-mobile.md -- O: VoiceOver and TalkBack guide for iOS and Android
298-
- appendix-p-github-pages.md -- P: GitHub Pages deployment guide
299-
- appendix-q-github-actions-workflows.md -- Q: Automation, CI/CD workflows, and agentic cloud
300-
- appendix-r-github-profile-sponsors-wikis.md -- R: Profile README, GitHub Sponsors, wikis
301-
- appendix-s-github-organizations-templates.md -- S: Organizations, templates, repository settings
302-
- appendix-t-contributing-to-open-source.md -- T: First contribution guide
303-
- appendix-u-resources.md -- U: Every link, tool, and reference (lookup anytime)
304-
- appendix-v-accessibility-agents-reference.md -- V: Accessibility Agents agents, commands, and customization
305-
- appendix-w-github-copilot-reference.md -- W: Copilot features, chat, MCP servers, agentic ecosystem
306-
- appendix-x-copilot-models.md -- X: AI model comparison and selection guide
307-
- appendix-y-accessing-workshop-materials.md -- Y: How to get, download, and read these materials
308-
- appendix-z-github-skills-catalog.md -- Z: All 36 GitHub Skills modules with learning paths
211+
```
212+
[repo root]/
213+
├── README.md ← You are here
214+
├── CONTRIBUTING.md ← How to contribute to this repo
215+
├── CODE_OF_CONDUCT.md ← Community standards
216+
├── FACILITATOR.md ← For workshop organizers only
217+
├── DAY1_AGENDA.md ← Day 1 workshop schedule (facilitators only)
218+
├── DAY2_AGENDA.md ← Day 2 workshop schedule (facilitators only)
219+
├── .gitignore
220+
├── .github/
221+
│ ├── ISSUE_TEMPLATE/
222+
│ │ ├── config.yml ← Links to GitHub Skills; disables blank issues
223+
│ │ ├── accessibility-bug.yml ← Structured accessibility bug form (YAML)
224+
│ │ └── feature-request.yml ← Feature/improvement request form (YAML)
225+
│ ├── PULL_REQUEST_TEMPLATE.md ← PR checklist with accessibility section
226+
│ ├── agents/ ← Accessibility Agents: workshop Copilot Chat agents (55 total across 3 teams)
227+
│ │ ├── daily-briefing.agent.md
228+
│ │ ├── issue-tracker.agent.md
229+
│ │ ├── pr-review.agent.md
230+
│ │ ├── analytics.agent.md
231+
│ │ ├── insiders-a11y-tracker.agent.md
232+
│ │ ├── template-builder.agent.md
233+
│ │ └── preferences.example.md ← Copy to preferences.md and personalize
234+
│ └── prompts/ ← 54+ slash commands for Copilot Chat
235+
│ ├── a11y-update.prompt.md
236+
│ ├── create-issue.prompt.md
237+
│ ├── daily-briefing.prompt.md
238+
│ ├── review-pr.prompt.md
239+
│ ├── triage.prompt.md
240+
│ └── ... (23 more - see appendix-v-accessibility-agents-reference.md)
241+
├── learning-room/ ← Practice target for the contribution sprint
242+
│ ├── README.md
243+
│ └── docs/
244+
│ ├── welcome.md ← Has [TODO] sections for you to complete
245+
│ ├── keyboard-shortcuts.md ← Has intentional accessibility issues to find and fix
246+
│ └── setup-guide.md ← Has a broken link to find and fix
247+
├── PODCASTS.md ← Audio player page (44 episodes, HTML5 audio)
248+
├── podcasts/ ← Podcast production pipeline
249+
│ ├── build-bundles.js ← Generates NotebookLM source bundles
250+
│ ├── generate-site.js ← Generates PODCASTS.md and RSS feed from manifest
251+
│ ├── manifest.json ← Episode manifest (status, metadata)
252+
│ ├── feed.xml ← RSS 2.0 podcast feed
253+
│ ├── README.md ← Production guide
254+
│ └── bundles/ ← 44 generated episode source bundles
255+
└── docs/ ← Full workshop curriculum (17 lessons + 26 appendices A-Z)
256+
├── course-guide.md ← Student landing page: day-by-day overview, exercises, help
257+
├── 00-pre-workshop-setup.md
258+
├── 01-understanding-github-web-structure.md ← How GitHub is organized (start here)
259+
├── 02-navigating-repositories.md ← Accessibility Agents: @daily-briefing
260+
├── 03-the-learning-room.md ← Read this early: your shared space and PR workflow
261+
├── 04-working-with-issues.md ← Accessibility Agents: @issue-tracker
262+
├── 05-working-with-pull-requests.md ← Accessibility Agents: @pr-review
263+
├── 06-merge-conflicts.md ← Accessibility Agents: Copilot conflict prevention
264+
├── 07-culture-etiquette.md ← Accessibility Agents: output responsibility
265+
├── 08-labels-milestones-projects.md ← Accessibility Agents: @issue-tracker + labels
266+
├── 09-notifications.md ← Accessibility Agents: @daily-briefing + inbox
267+
├── 10-vscode-basics.md ← VS Code setup, github.dev, screen reader mode, accessibility basics
268+
├── 11-git-source-control.md ← Git operations in VS Code: clone, branch, commit, merge, stash
269+
├── 12-github-pull-requests-extension.md ← GitHub PR extension: view, review, create, merge PRs
270+
├── 13-github-copilot.md ← GitHub Copilot: inline suggestions, Chat, prompting, custom agents
271+
├── 14-accessible-code-review.md ← Reviewer mechanics: diffs, comments, Accessible Diff Viewer - final culminating skill
272+
├── 15-issue-templates.md ← Creating GitHub issue templates
273+
├── 16-accessibility-agents.md ← Accessibility Agents: 55 agents, 3 teams, 5 platforms - automate everything you learned
274+
├── appendix-a-glossary.md ← A: Every term explained (look up any time)
275+
├── appendix-b-screen-reader-cheatsheet.md ← B: Full shortcut reference, per-screen-reader tables (keep open)
276+
├── appendix-c-accessibility-standards.md ← C: WCAG 2.2, ARIA, PR checklist
277+
├── appendix-d-git-authentication.md ← D: SSH keys, PATs, credential storage
278+
├── appendix-e-github-flavored-markdown.md ← E: Alert blocks, Mermaid, math, footnotes, heading anchors
279+
├── appendix-f-github-gists.md ← F: Code snippets, sharing, embedding
280+
├── appendix-g-github-discussions.md ← G: GitHub Discussions navigation and participation
281+
├── appendix-h-releases-tags-insights.md ← H: Releases, tags, version numbers, pulse, contributors, traffic
282+
├── appendix-i-github-projects.md ← I: GitHub Projects deep dive (boards, tables, roadmaps, automations)
283+
├── appendix-j-advanced-search.md ← J: Search query language reference
284+
├── appendix-k-branch-protection-rulesets.md ← K: Branch rules, rulesets, diagnosing blocked PRs
285+
├── appendix-l-github-security-features.md ← L: Dependabot, secret scanning, code scanning, private advisories
286+
├── appendix-m-vscode-accessibility-reference.md ← M: Complete VS Code accessibility technical reference
287+
├── appendix-n-github-codespaces.md ← N: Cloud dev environments, accessibility setup, screen reader usage
288+
├── appendix-o-github-mobile.md ← O: VoiceOver and TalkBack guide for iOS and Android
289+
├── appendix-p-github-pages.md ← P: GitHub Pages deployment guide
290+
├── appendix-q-github-actions-workflows.md ← Q: Automation, CI/CD workflows, and agentic cloud
291+
├── appendix-r-github-profile-sponsors-wikis.md ← R: Profile README, GitHub Sponsors, wikis
292+
├── appendix-s-github-organizations-templates.md ← S: Organizations, templates, repository settings
293+
├── appendix-t-contributing-to-open-source.md ← T: First contribution guide
294+
├── appendix-u-resources.md ← U: Every link, tool, and reference (lookup anytime)
295+
├── appendix-v-accessibility-agents-reference.md ← V: Accessibility Agents agents, commands, and customization
296+
├── appendix-w-github-copilot-reference.md ← W: Copilot features, chat, MCP servers, agentic ecosystem
297+
├── appendix-x-copilot-models.md ← X: AI model comparison and selection guide
298+
├── appendix-y-accessing-workshop-materials.md ← Y: How to get, download, and read these materials
299+
└── appendix-z-github-skills-catalog.md ← Z: All 36 GitHub Skills modules with learning paths
309300
310301
> *Note: Appendices were renumbered during a February 2026 review. If you encounter external references to "Appendix D" or later letters, subtract one letter (e.g., the former Appendix D is now [Appendix C](docs/appendix-c-accessibility-standards.md)).*
311302

docs/03-the-learning-room.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,7 +129,16 @@ When you join the workshop, the facilitator creates a **personal practice branch
129129
3. Push your practice branch to GitHub
130130
4. Open a pull request from your practice branch → `main`
131131

132-
> **Note:** For GitHub web-based editing (Chapters 4-5), you can create temporary feature branches with descriptive names like `fix/welcome-todos` or `add/keyboard-shortcuts`. Your practice branch becomes essential when you start working locally with Git in Chapter 11.
132+
> **Which branch do I use and when?**
133+
>
134+
> | Chapter | Branch needed? | What to use |
135+
> |---------|---------------|-------------|
136+
> | Chapter 4 (Issues) | No | Work happens in issue threads directly. No branch or file editing required. |
137+
> | Chapter 5 (PRs, web editor) | Yes, auto-created | GitHub creates a branch when you click "Propose changes." Name it `fix/yourname-issueXX`. |
138+
> | Chapter 5 (PRs, local clone) | Yes, create manually | `git checkout -b fix/yourname-issueXX` from `main`. |
139+
> | Chapter 11+ (Local Git) | Yes | Use your `username-practice` branch or create `fix/yourname-issueXX` branches from `main`. |
140+
>
141+
> **Summary:** Chapter 4 needs no branch. Chapters 5-10 use short-lived `fix/` branches. Your `username-practice` branch becomes essential starting in Chapter 11 when you work locally with Git and VS Code.
133142
134143

135144
## The Practice Files: What You Will Work On

0 commit comments

Comments
 (0)