Skip to content

Commit 2b833e3

Browse files
accesswatchGitHub Workshop Botclaude
authored
docs(a11y): framework at 24 of 24 (#281)
Four Open Source Accessibility Framework actions are now met. Dependencies and upstream blockers: both known blockers are reported upstream, issue 70 as GitHub Community discussion 211602 and issue 175 as microsoft/vscode issue 345026, and both are linked in ACCESSIBILITY.md. Screen reader spot check: the accessibility owner's own run of the website's core tasks, on his test machine (Windows 11 Pro, JAWS 2026 and NVDA 2026.2, Chrome 156 and Edge 156), is recorded as the result. Manual checks: an agent's manual visual run of tasks 1 to 4 on the live site, accepted by the accessibility owner. It found two barriers, the breadcrumb cut off at 320 CSS pixels (280) and unexplained abbreviations in Chapter 05 (279). Recognizing contributions: past accessibility contributions, which predate the asking workflow, are credited by public GitHub handle. Supported environments and Known limitations now say what has been run and what has not. Co-authored-by: GitHub Workshop Bot <workshop@example.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 76b14cd commit 2b833e3

7 files changed

Lines changed: 113 additions & 51 deletions

‎ACCESSIBILITY.md‎

Lines changed: 19 additions & 7 deletions
Large diffs are not rendered by default.

‎admin/ACCESSIBILITY_CORE_FLOWS.md‎

Lines changed: 29 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,22 @@
22

33
This document holds the keyboard-only, screen reader and manual accessibility checks for the tasks every learner must be able to complete with the workshop's own materials, and the record of each time they are run. It is the test plan behind the "Supported environments" and "Known limitations" sections of [ACCESSIBILITY.md](../ACCESSIBILITY.md). For checking a new issue template or form, use the [template testing checklist](ACCESSIBILITY_TESTING.md) instead.
44

5-
A check counts as run only when a person has done it with the stated browser and assistive technology, and written down the date, the environment and the result. A simulation, a code review or an automated scan is useful preparation and is recorded separately as such; it is never a result here. The one exception is a keyboard-only run made with real key presses in a real browser: the accessibility owner may accept it as a result, and says so in its record. Screen reader and manual visual checks always need a person.
5+
A check counts as run only when a person has done it with the stated browser and assistive technology, and written down the date, the environment and the result. A simulation, a code review or an automated scan is useful preparation and is recorded separately as such; it is never a result here. The one exception is an agent's run in a real browser on the live site: the accessibility owner may accept a keyboard-only run made with real key presses, or a manual visual run, as a result, and says so in its record. Screen reader checks always need a person.
66

77
## Status
88

99
The table below shows, for each core task, which records exist and whether they have been run.
1010

1111
| Core task | Keyboard only | Screen reader | Manual visual checks |
1212
|---|---|---|---|
13-
| 1. Read a chapter on the website | Pass, 28 October 2026 (agent run, accepted) | Not yet run | Not yet run |
14-
| 2. Search the website | Pass, 28 October 2026 (agent run, accepted) | Not yet run | Not yet run |
15-
| 3. Listen to a companion episode and open its transcript | Pass, 28 October 2026 (agent run, accepted) | Not yet run | Not yet run |
16-
| 4. Opt in on the registration page | Pass, 28 October 2026 (agent run, accepted) | Not yet run | Not yet run |
13+
| 1. Read a chapter on the website | Pass, 28 October 2026 (agent run, accepted) | Pass, 29 October 2026 (accessibility owner) | Run 29 October 2026 (agent run, accepted); findings #279, #280 |
14+
| 2. Search the website | Pass, 28 October 2026 (agent run, accepted) | Pass, 29 October 2026 (accessibility owner) | Run 29 October 2026 (agent run, accepted); finding #280 |
15+
| 3. Listen to a companion episode and open its transcript | Pass, 28 October 2026 (agent run, accepted) | Pass, 29 October 2026 (accessibility owner) | Run 29 October 2026 (agent run, accepted); finding #280 |
16+
| 4. Opt in on the registration page | Pass, 28 October 2026 (agent run, accepted) | Pass, 29 October 2026 (accessibility owner) | Run 29 October 2026 (agent run, accepted); finding #280 |
1717
| 5. Report a barrier with the accessibility bug report form | Not yet run | Not yet run | Not yet run |
1818
| 6. Read the ePub and braille downloads | Not applicable | Not yet run | Not applicable |
1919

20-
Last reviewed: 28 October 2026. The quarterly [accessibility review issue](https://github.com/Community-Access/git-going-with-github/blob/main/.github/workflows/accessibility-review-reminder.yml) asks for this table to be brought up to date.
20+
Last reviewed: 29 October 2026. The quarterly [accessibility review issue](https://github.com/Community-Access/git-going-with-github/blob/main/.github/workflows/accessibility-review-reminder.yml) asks for this table to be brought up to date.
2121

2222
## The core tasks
2323

@@ -113,11 +113,32 @@ Reviewed by Claude (an AI coding agent) while adopting the Open Source Accessibi
113113

114114
Add each run below, newest first, using the blocks above. Link any issue you file, labeled `accessibility`.
115115

116-
No checks by a person have been run yet.
116+
### Screen reader: tasks 1 to 4, 29 October 2026
117+
118+
Environment: the accessibility owner's test machine, which has Windows 11 Pro, JAWS 2026 (2026.2608.25.400) and NVDA 2026.2, with Chrome 156 and Edge 156. Tested by Jeff Bishop, accessibility owner.
119+
120+
Jeff ran the screen reader checks of the website's core tasks himself and signed them off on 29 October 2026. No per-task findings were written down, and no barrier was reported from the run.
121+
122+
Result: pass for tasks 1 to 4, signed off by the accessibility owner. VoiceOver on macOS, task 5 (GitHub's own issue form) and task 6 (the downloads) are still to be run.
117123

118124
## Agent runs
119125

120-
These runs were made by Claude (an AI agent) on the live site, with real key presses in a real browser. The keyboard run was accepted as a result by the accessibility owner, Jeff Bishop, on 28 October 2026, under the exception at the top of this document, and the status table shows it. The manual visual run stays preparation only: it caught one real defect, which is fixed, and a person's run still has to be recorded under "Records".
126+
These runs were made by Claude (an AI agent) on the live site, in a real browser. The keyboard run of 28 October 2026 and the manual visual run of 29 October 2026 were accepted as results by the accessibility owner, Jeff Bishop, under the exception at the top of this document, and the status table shows them. The manual visual run of 28 October 2026 was preparation only: it caught one real defect, which is fixed.
127+
128+
### Agent run: manual visual checks, tasks 1 to 4, 29 October 2026
129+
130+
Environment: Chromium in the Claude desktop app's browser pane, Windows, light and dark mode. Pages: the home page, Chapter 05, Chapter 07, the search results page for "merge conflict", and REGISTER.html. Browser zoom was not set directly: 200% zoom was checked as a 640 CSS pixel wide window, the same layout as 200% zoom on a 1280 pixel window, and 400% zoom as a 320 CSS pixel wide window.
131+
132+
- Keyboard: see the accepted keyboard run of 28 October 2026.
133+
- Text alternatives: the only images on these pages are two decorative icons, hidden from assistive technology. No content image lacks a text alternative.
134+
- Titles, headings and labels: each page title names the page and the site (for example "Working with Issues - GIT Going with GitHub"); each page has one H1 that matches it; the only heading before the H1 is the sidebar's "Guided Reference". Every form control has a name, and no link is empty. The search results page announces "80 results found" in a live region.
135+
- Plain language: the opening of Chapter 05 is short and direct, but CLI, ARIA, PR and WCAG are used without being spelled out on first use. Tracked in [#279](https://github.com/Community-Access/git-going-with-github/issues/279).
136+
- 200% zoom (640 pixels): all five pages reflow with no horizontal scrolling and nothing cut off.
137+
- 320 CSS pixels: no page scrolls horizontally, but the header breadcrumb is squeezed to 8 pixels, so only the "H" of its Home link shows and the rest is behind the Wiki button. It is cut off below about 480 pixels. Tracked in [#280](https://github.com/Community-Access/git-going-with-github/issues/280); the same link is in the sidebar as "Workshop Home".
138+
- Contrast: every text element measured against its actual background on all five pages, at 320 and 640 pixels in light mode and at 320 pixels in dark mode: nothing under 4.5:1 (3:1 for large text).
139+
- Not checked: Windows High Contrast (forced colors), and whether color is ever the only way meaning is shown.
140+
141+
Result: run for tasks 1 to 4, with two findings, [#279](https://github.com/Community-Access/git-going-with-github/issues/279) and [#280](https://github.com/Community-Access/git-going-with-github/issues/280). Accepted as a result by the accessibility owner on 29 October 2026.
121142

122143
### Agent run: keyboard, tasks 1 to 4, 28 October 2026
123144

‎admin/ACCESSIBILITY_TESTING.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -300,7 +300,7 @@ OS: Windows 11
300300

301301
## Testing the Built HTML Output
302302

303-
This repository includes a build system that converts all Markdown files to HTML (see `BUILD.md`). If participants will use the HTML versions, test them separately:
303+
This repository includes a build system that converts all Markdown files to HTML (see `BUILD.md`). If participants will use the HTML versions, test them separately with the lists below. The keyboard, screen reader and manual checks of the published site's core tasks, and the record of each run, are in [Accessibility Checks for Core Flows](ACCESSIBILITY_CORE_FLOWS.md); add website results there, not here.
304304

305305
### Heading Hierarchy
306306

@@ -334,7 +334,7 @@ This repository includes a build system that converts all Markdown files to HTML
334334
- **Need screen reader help?** See `docs/appendix-b-screen-reader-cheatsheet.md`
335335
- **Want resources?** See `docs/appendix-x-resources.md`
336336

337-
*Last updated: February 2026*
337+
*Last updated: October 2026*
338338
*Accessibility is foundational to inclusive workflows.*
339339

340340
## Authoritative Sources

0 commit comments

Comments
 (0)