Skip to content

Commit aa41a81

Browse files
committed
Replace box-drawing tree with plain text lists in README
1 parent 7b9e483 commit aa41a81

1 file changed

Lines changed: 98 additions & 89 deletions

File tree

README.md

Lines changed: 98 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -208,95 +208,104 @@ 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-
```
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
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
300309

301310
> *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)).*
302311

0 commit comments

Comments
 (0)