Skip to content

Commit 047073a

Browse files
accesswatchclaude
andauthored
docs(a11y): count the accepted keyboard run (#276)
The accessibility owner accepted the agent keyboard run of tasks 1 to 4 (real key presses in a real browser) as a result. The core-flow rule now allows that one exception, the status table shows the four passes, and ACCESSIBILITY.md says 20 of 24. Claude-Session: https://claude.ai/code/session_01PmRBrUTuhzYnQBFxUCN6Vr Co-authored-by: Claude <noreply@anthropic.com>
1 parent 6f86dcc commit 047073a

5 files changed

Lines changed: 19 additions & 19 deletions

File tree

‎ACCESSIBILITY.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -209,11 +209,11 @@ The accessibility owner keeps these current. Report a problem with any of them t
209209

210210
## Open Source Accessibility Framework
211211

212-
We follow the [Open Source Accessibility Framework](https://open-source-accessibility.github.io/Open-Source-Accessibility-Framework/) in its four phases and record our progress, action by action, in our public tracking issue, [GIT Going with GitHub, issue 55](https://github.com/open-source-accessibility/Open-Source-Accessibility-Framework/issues/55), in the framework's repository. Progress is self-reported, and an action is checked there only when its definition of done is fully met: 19 of 24 as of 28 October 2026. Docs accessible by default is checked: the documentation check's 264 findings were fixed in pull request 271, and the 3 left are deliberate bad examples in Appendix C. Accessible interfaces is checked: the site's fixes from issues 265 and 266 were confirmed on the live site in a browser, with a visible focus outline in light and dark mode (5.19:1 and 3.49:1) and a search box named by its visible label. One workflow action described below is in place but stays unchecked for now: dependencies (the two known blockers have no upstream report yet). As of October 2026:
212+
We follow the [Open Source Accessibility Framework](https://open-source-accessibility.github.io/Open-Source-Accessibility-Framework/) in its four phases and record our progress, action by action, in our public tracking issue, [GIT Going with GitHub, issue 55](https://github.com/open-source-accessibility/Open-Source-Accessibility-Framework/issues/55), in the framework's repository. Progress is self-reported, and an action is checked there only when its definition of done is fully met: 20 of 24 as of 28 October 2026. The keyboard-only smoke test is checked: tasks 1 to 4 passed with real key presses in a browser, a run the accessibility owner accepted (see admin/ACCESSIBILITY_CORE_FLOWS.md). Docs accessible by default is checked: the documentation check's 264 findings were fixed in pull request 271, and the 3 left are deliberate bad examples in Appendix C. Accessible interfaces is checked: the site's fixes from issues 265 and 266 were confirmed on the live site in a browser, with a visible focus outline in light and dark mode (5.19:1 and 3.49:1) and a search box named by its visible label. One workflow action described below is in place but stays unchecked for now: dependencies (the two known blockers have no upstream report yet). As of October 2026:
213213

214214
- **Foundational:** this document; the `accessibility` label, applied to accessibility reports and work.
215215
- **Workflow:** priorities, contributor expectations and interface requirements above, linked from [CONTRIBUTING.md](CONTRIBUTING.md); the accessibility bug report form with an email alternative; severity and response; the pull request checklist; `good first issue` and `help wanted` accessibility issues with acceptance criteria; an owner; documentation checked by the automated check; dependencies and upstream blockers recorded.
216-
- **Testing:** the documentation accessibility check in CI, with its findings tracked; documentation reviewed; supported environments and known limitations above. Keyboard, screen reader and manual checks of the core tasks are written down but not yet run and recorded.
216+
- **Testing:** the documentation accessibility check in CI, with its findings tracked; documentation reviewed; supported environments and known limitations above. A keyboard-only run of the core tasks on the website passed and is recorded; screen reader and manual checks are written down but not yet run by a person.
217217
- **Community:** a feedback form after each cohort and labeled issues to invite help; documented responses to reports; asynchronous and live ways to take part, a private route for accommodations and a Code of Conduct; quarterly progress updates; reusable materials. Crediting accessibility contributors with their consent is the practice above, and has not yet happened.
218218

219219
## Feedback

‎admin/ACCESSIBILITY_CORE_FLOWS.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
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.
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.
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 | Not yet run | Not yet run | Not yet run |
14-
| 2. Search the website | Not yet run | Not yet run | Not yet run |
15-
| 3. Listen to a companion episode and open its transcript | Not yet run | Not yet run | Not yet run |
16-
| 4. Opt in on the registration page | Not yet run | Not yet run | Not yet run |
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 |
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

@@ -117,7 +117,7 @@ No checks by a person have been run yet.
117117

118118
## Agent runs
119119

120-
These runs were made by Claude (an AI agent) on the live site, with real key presses in a real browser. By the rule at the top of this document they are preparation, not results: they show what a person's run should find, and they caught one real defect, which is fixed. A person's run still has to be recorded under "Records" before the status table changes.
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".
121121

122122
### Agent run: keyboard, tasks 1 to 4, 28 October 2026
123123

@@ -133,7 +133,7 @@ Environment: Chromium in the Claude desktop app's browser pane, Windows, 1280 by
133133
- Task 4: the enrollment link, "Begin the Adventure (opens in new tab)", is reached by Tab.
134134
- Task 5 was not run: the form is on GitHub and needs a signed-in account.
135135

136-
Result: no keyboard failures found.
136+
Result: pass for tasks 1 to 4, no keyboard failures found. Accepted as a result by the accessibility owner on 28 October 2026. Task 5 is GitHub's own issue form and is still to be run while signed in.
137137

138138
### Agent run: manual visual checks, tasks 1 to 4, 28 October 2026
139139

‎html/ACCESSIBILITY.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -413,11 +413,11 @@ <h2 id="reusing-our-accessibility-materials">Reusing our accessibility materials
413413
</ul>
414414
<p>The accessibility owner keeps these current. Report a problem with any of them the same way as any other barrier.</p>
415415
<h2 id="open-source-accessibility-framework">Open Source Accessibility Framework</h2>
416-
<p>We follow the <a href="https://open-source-accessibility.github.io/Open-Source-Accessibility-Framework/">Open Source Accessibility Framework</a> in its four phases and record our progress, action by action, in our public tracking issue, <a href="https://github.com/open-source-accessibility/Open-Source-Accessibility-Framework/issues/55">GIT Going with GitHub, issue 55</a>, in the framework&#39;s repository. Progress is self-reported, and an action is checked there only when its definition of done is fully met: 19 of 24 as of 28 October 2026. Docs accessible by default is checked: the documentation check&#39;s 264 findings were fixed in pull request 271, and the 3 left are deliberate bad examples in Appendix C. Accessible interfaces is checked: the site&#39;s fixes from issues 265 and 266 were confirmed on the live site in a browser, with a visible focus outline in light and dark mode (5.19:1 and 3.49:1) and a search box named by its visible label. One workflow action described below is in place but stays unchecked for now: dependencies (the two known blockers have no upstream report yet). As of October 2026:</p>
416+
<p>We follow the <a href="https://open-source-accessibility.github.io/Open-Source-Accessibility-Framework/">Open Source Accessibility Framework</a> in its four phases and record our progress, action by action, in our public tracking issue, <a href="https://github.com/open-source-accessibility/Open-Source-Accessibility-Framework/issues/55">GIT Going with GitHub, issue 55</a>, in the framework&#39;s repository. Progress is self-reported, and an action is checked there only when its definition of done is fully met: 20 of 24 as of 28 October 2026. The keyboard-only smoke test is checked: tasks 1 to 4 passed with real key presses in a browser, a run the accessibility owner accepted (see admin/ACCESSIBILITY_CORE_FLOWS.md). Docs accessible by default is checked: the documentation check&#39;s 264 findings were fixed in pull request 271, and the 3 left are deliberate bad examples in Appendix C. Accessible interfaces is checked: the site&#39;s fixes from issues 265 and 266 were confirmed on the live site in a browser, with a visible focus outline in light and dark mode (5.19:1 and 3.49:1) and a search box named by its visible label. One workflow action described below is in place but stays unchecked for now: dependencies (the two known blockers have no upstream report yet). As of October 2026:</p>
417417
<ul>
418418
<li><strong>Foundational:</strong> this document; the <code>accessibility</code> label, applied to accessibility reports and work.</li>
419419
<li><strong>Workflow:</strong> priorities, contributor expectations and interface requirements above, linked from <a href="CONTRIBUTING.html">CONTRIBUTING.md</a>; the accessibility bug report form with an email alternative; severity and response; the pull request checklist; <code>good first issue</code> and <code>help wanted</code> accessibility issues with acceptance criteria; an owner; documentation checked by the automated check; dependencies and upstream blockers recorded.</li>
420-
<li><strong>Testing:</strong> the documentation accessibility check in CI, with its findings tracked; documentation reviewed; supported environments and known limitations above. Keyboard, screen reader and manual checks of the core tasks are written down but not yet run and recorded.</li>
420+
<li><strong>Testing:</strong> the documentation accessibility check in CI, with its findings tracked; documentation reviewed; supported environments and known limitations above. A keyboard-only run of the core tasks on the website passed and is recorded; screen reader and manual checks are written down but not yet run by a person.</li>
421421
<li><strong>Community:</strong> a feedback form after each cohort and labeled issues to invite help; documented responses to reports; asynchronous and live ways to take part, a private route for accommodations and a Code of Conduct; quarterly progress updates; reusable materials. Crediting accessibility contributors with their consent is the practice above, and has not yet happened.</li>
422422
</ul>
423423
<h2 id="feedback">Feedback</h2>

‎html/admin/ACCESSIBILITY_CORE_FLOWS.html‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ <h2 class="onpage-title">On This Page</h2>
221221
</nav>
222222
<div id="course-content"><h1 id="accessibility-checks-for-core-flows">Accessibility Checks for Core Flows</h1>
223223
<p>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&#39;s own materials, and the record of each time they are run. It is the test plan behind the &quot;Supported environments&quot; and &quot;Known limitations&quot; sections of <a href="../ACCESSIBILITY.html">ACCESSIBILITY.md</a>. For checking a new issue template or form, use the <a href="ACCESSIBILITY_TESTING.html">template testing checklist</a> instead.</p>
224-
<p>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.</p>
224+
<p>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.</p>
225225
<h2 id="status">Status</h2>
226226
<p>The table below shows, for each core task, which records exist and whether they have been run.</p>
227227
<table>
@@ -235,25 +235,25 @@ <h2 id="status">Status</h2>
235235
</thead>
236236
<tbody><tr>
237237
<td>1. Read a chapter on the website</td>
238-
<td>Not yet run</td>
238+
<td>Pass, 28 October 2026 (agent run, accepted)</td>
239239
<td>Not yet run</td>
240240
<td>Not yet run</td>
241241
</tr>
242242
<tr>
243243
<td>2. Search the website</td>
244-
<td>Not yet run</td>
244+
<td>Pass, 28 October 2026 (agent run, accepted)</td>
245245
<td>Not yet run</td>
246246
<td>Not yet run</td>
247247
</tr>
248248
<tr>
249249
<td>3. Listen to a companion episode and open its transcript</td>
250-
<td>Not yet run</td>
250+
<td>Pass, 28 October 2026 (agent run, accepted)</td>
251251
<td>Not yet run</td>
252252
<td>Not yet run</td>
253253
</tr>
254254
<tr>
255255
<td>4. Opt in on the registration page</td>
256-
<td>Not yet run</td>
256+
<td>Pass, 28 October 2026 (agent run, accepted)</td>
257257
<td>Not yet run</td>
258258
<td>Not yet run</td>
259259
</tr>
@@ -348,7 +348,7 @@ <h2 id="records">Records</h2>
348348
<p>Add each run below, newest first, using the blocks above. Link any issue you file, labeled <code>accessibility</code>.</p>
349349
<p>No checks by a person have been run yet.</p>
350350
<h2 id="agent-runs">Agent runs</h2>
351-
<p>These runs were made by Claude (an AI agent) on the live site, with real key presses in a real browser. By the rule at the top of this document they are preparation, not results: they show what a person&#39;s run should find, and they caught one real defect, which is fixed. A person&#39;s run still has to be recorded under &quot;Records&quot; before the status table changes.</p>
351+
<p>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&#39;s run still has to be recorded under &quot;Records&quot;.</p>
352352
<h3 id="agent-run-keyboard-tasks-1-to-4-28-october-2026">Agent run: keyboard, tasks 1 to 4, 28 October 2026</h3>
353353
<p>Environment: Chromium in the Claude desktop app&#39;s browser pane, Windows, 1280 by 900 and 320 by 720 windows. Pages: the home page, Chapter 05, Chapter 07, the search results page for &quot;merge conflict&quot;, and REGISTER.html.</p>
354354
<ul>
@@ -362,7 +362,7 @@ <h3 id="agent-run-keyboard-tasks-1-to-4-28-october-2026">Agent run: keyboard, ta
362362
<li>Task 4: the enrollment link, &quot;Begin the Adventure (opens in new tab)&quot;, is reached by Tab.</li>
363363
<li>Task 5 was not run: the form is on GitHub and needs a signed-in account.</li>
364364
</ul>
365-
<p>Result: no keyboard failures found.</p>
365+
<p>Result: pass for tasks 1 to 4, no keyboard failures found. Accepted as a result by the accessibility owner on 28 October 2026. Task 5 is GitHub&#39;s own issue form and is still to be run while signed in.</p>
366366
<h3 id="agent-run-manual-visual-checks-tasks-1-to-4-28-october-2026">Agent run: manual visual checks, tasks 1 to 4, 28 October 2026</h3>
367367
<p>Same environment. Contrast was measured for every text element against its actual background colour, in light and dark mode.</p>
368368
<ul>

0 commit comments

Comments
 (0)