Skip to content

Commit f870815

Browse files
accesswatchclaude
andauthored
Fix documentation and site accessibility findings (#264-#268) (#271)
* fix(site): show Quick Jumps focus outline and match search box name to its label Remove outline: none from the .quick-jumps-list a:focus rule so the site-wide a:focus-visible outline (2px solid, blue) applies to the Quick Jumps links again (WCAG 2.4.7 Focus Visible). Hover still underlines the link; the dark-mode and high-contrast rules only change colors and do not remove the outline. Remove aria-label="Search documentation" from the site-search input on every page and on the search page, so the field takes its accessible name, "Search docs", from its label, which matches the visible placeholder (WCAG 2.5.3 Label in Name). Regenerated html/ with npm run build:html. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PmRBrUTuhzYnQBFxUCN6Vr * docs: clear the known documentation accessibility findings Emoji (172 findings, four admin guides): - FACILITATOR_GUIDE.md and FACILITATOR_RESOURCES.md: remove the emoji from every heading, from running text and from the Section-Level Source Maps. Update every link to the changed anchors in both files and in admin/README.md (#-github-classroom-setup-before-day-1 becomes #github-classroom-setup-before-day-1, and so on). Describe the pencil icon by its button name, "Edit this file", instead of an emoji. - Point the guide's broken in-page link to a nonexistent "Troubleshooting GitHub Classroom Setup" heading at "Known Gotchas", the section directly below it. - FACILITATOR_OPERATIONS.md: remove the emoji from the sample chat messages and the narrated demo script. - CURRICULUM_2.0_ORGANIZATION.md: replace each check mark with the word it stood for ("Complete", "Yes") or drop it from lists whose heading already says the items are done. Code block languages (88 findings, 34 files): add a language to every fenced code block that had none: bash for shell commands, bat for the Windows batch files, markdown for Markdown source, and text for output, file trees, conflict examples, sample messages and keystroke steps. Nothing inside any block changed. Heading: give admin/classroom admin access.md a title and a sentence of context. The documentation check now reports 3 findings, all the deliberate "bad example" links in Appendix C; the baseline shrinks from 264 to 3. Regenerated html/ with npm run build:html. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PmRBrUTuhzYnQBFxUCN6Vr --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent e95fbfc commit f870815

258 files changed

Lines changed: 1077 additions & 1402 deletions

File tree

Some content is hidden

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

‎BATCH.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Run operations in this sequence for a full podcast build from scratch:
1818
Validates the podcast catalog, builds episode and challenge bundles, then writes
1919
all episode and challenge coach scripts to `podcasts\scripts\`.
2020

21-
```
21+
```bat
2222
generate-transcripts.bat
2323
```
2424

@@ -38,7 +38,7 @@ The script echoes each episode name and index as it is processed.
3838
ffmpeg is required for MP3 output and is located automatically from the
3939
machine PATH, including after a fresh winget install.
4040

41-
```
41+
```text
4242
generate-audio.bat generate all 75 episodes
4343
generate-audio.bat 5 generate episodes 5 and above
4444
generate-audio.bat 5 10 generate episodes 5 through 10
@@ -54,7 +54,7 @@ before running this command.
5454
Generates the RSS 2.0 / iTunes-compatible podcast feed and the admin podcast listing.
5555
Reads MP3 file sizes from `podcasts\audio\` and episode metadata from the catalog.
5656

57-
```
57+
```bat
5858
build-rss-feed.bat
5959
```
6060

@@ -70,7 +70,7 @@ reflect the final MP3 file sizes.
7070

7171
Runs local RSS 2.0 and iTunes compliance checks on `podcasts\feed.xml`.
7272

73-
```
73+
```bat
7474
validate-rss-feed.bat
7575
```
7676

@@ -114,7 +114,7 @@ a PowerShell or bash session at the repo root.
114114

115115
To pass a range to the audio build from npm:
116116

117-
```
117+
```bash
118118
npm run build:podcast-audio -- --start 5 --end 10
119119
```
120120

‎CONTRIBUTING.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ git remote -v
100100

101101
Expected output:
102102

103-
```
103+
```text
104104
origin https://github.com/[your-username]/[workshop-repo-name].git (fetch)
105105
origin https://github.com/[your-username]/[workshop-repo-name].git (push)
106106
upstream https://github.com/[original-owner]/[workshop-repo-name].git (fetch)
@@ -164,7 +164,7 @@ which is not a term NVDA uses. Updated to match NVDA's own terminology."
164164

165165
**Commit message format:**
166166

167-
```
167+
```text
168168
type: short summary (under 72 characters)
169169
170170
Optional longer explanation of why the change was made, not just what
@@ -402,7 +402,7 @@ When you open a pull request, fill in the template that appears. If no template
402402

403403
### PR Title Format
404404

405-
```
405+
```text
406406
fix: correct JAWS shortcut for PR review in Section 3
407407
docs: add alternative macOS exercise for Section 6
408408
exercise: add bonus challenge for notifications day 2

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ You do **not** need to know how to code to participate and contribute meaningful
9696

9797
This is not a two-day course with two separate syllabi. It is one arc.
9898

99-
```
99+
```text
100100
Day 1 - Learn the skill in the browser
101101
Navigate → Issue → Pull Request → Review → Merge
102102
@@ -233,7 +233,7 @@ Every chapter has an "If You Get Stuck" section. Every challenge has a [referenc
233233

234234
> **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`.
235235
236-
```
236+
```text
237237
[repo root]/
238238
├── README.md -- You are here
239239
├── CONTRIBUTING.md -- How to contribute to this repo

‎admin/ACCESSIBILITY_TESTING.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Use before deploying any new issue template or form.
4949

5050
### NVDA Testing (Windows)
5151

52-
```
52+
```text
5353
1. Press NVDA+Space to enable browse mode on page
5454
2. Press H to navigate to first heading
5555
3. Use H repeatedly to scan all headings (should be H1 → H2 → H3, not jumps)
@@ -73,7 +73,7 @@ Use before deploying any new issue template or form.
7373

7474
### JAWS Testing (Windows)
7575

76-
```
76+
```text
7777
1. Press Spacebar to enter browse mode
7878
2. Press Insert+F6 to open headings list
7979
- Verify headings are in order (1 → 2 → 3, no jumps)
@@ -97,7 +97,7 @@ Use before deploying any new issue template or form.
9797

9898
### VoiceOver Testing (macOS)
9999

100-
```
100+
```text
101101
1. Press VO+U to open Web Rotor
102102
2. Navigate to Form Controls section
103103
- Should list all fields
@@ -275,7 +275,7 @@ Test WITHOUT using the mouse.
275275

276276
When you find an accessibility problem, document it:
277277

278-
```
278+
```text
279279
Title: [Accessibility] Form label missing on email field
280280
281281
Description:

‎admin/AGENTS_ROADMAP.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ This document tracks the curriculum's alignment with Accessibility Agents versio
5757

5858
**Example:**
5959

60-
```
60+
```text
6161
Version 4.x:
6262
User: @aria-specialist audit this component
6363
Agent: [Reports 3 ARIA errors]
@@ -75,7 +75,7 @@ Agent: [Returns remediated code for approval]
7575
**Before (4.x):** No automated compliance reporting.
7676
**Now (5.0.0+):** Generate VPAT and compliance reports automatically.
7777

78-
```
78+
```text
7979
User: @document-csv-reporter generate-vpat audit-findings.json
8080
Agent: [Exports findings mapped to WCAG 2.2 AA and Section 508]
8181
Agent: [Generates VPAT template with compliance assertions]
@@ -89,7 +89,7 @@ Output: compliance-report.xlsx
8989

9090
**Capability:**
9191

92-
```
92+
```text
9393
Hook configuration:
9494
{
9595
"name": "continuous-eval",
@@ -265,7 +265,7 @@ Output: Trend report showing score changes week-over-week
265265

266266
### Three Teams, 80 Agents, 5 Platforms
267267

268-
```
268+
```text
269269
Accessibility Agents 5.0.0
270270
├── Team 1: Accessibility (40 agents)
271271
│ ├── Web (26): Specialists, wizards, coaches

0 commit comments

Comments
 (0)