You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit ea74282
Browse filesBrowse the repository at this point in the historyBrowse files
authored
docs(a11y): drop known limitations fixed in #273 (#282)
The Quick Jumps focus outline (#265) and the search box name (#266) were
fixed and confirmed on the live site in #273, so they are no longer known
limitations or remaining work in the October update.
Co-authored-by: GitHub Workshop Bot <workshop@example.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: ACCESSIBILITY.md
+1-3Lines changed: 1 addition & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -174,8 +174,6 @@ What has been checked:
174
174
These are the barriers we know about, what they mean for you, and what to do instead. Please [report any we have missed](#reporting-accessibility-issues).
175
175
176
176
-**Website testing is partial.** Keyboard, screen reader and manual visual checks of the website's core tasks 1 to 4 are [recorded](admin/ACCESSIBILITY_CORE_FLOWS.md), on Windows only. Not yet run: the accessibility bug report form (task 5), the ePub and braille downloads (task 6), VoiceOver on macOS, and Windows High Contrast. The manual check found two barriers: the breadcrumb is cut off at narrow widths and high zoom ([#280](https://github.com/Community-Access/git-going-with-github/issues/280)), and Chapter 05 uses abbreviations without spelling them out ([#279](https://github.com/Community-Access/git-going-with-github/issues/279)). Workaround for the breadcrumb: the same Home link is in the sidebar as "Workshop Home".
177
-
-**The Quick Jumps links hide their focus outline.** On every chapter page, keyboard focus on the Quick Jumps links shows only an underline and a faint background, which is hard to see with low vision ([#265](https://github.com/Community-Access/git-going-with-github/issues/265)). Workaround: the same links are in the "On this page" list and the page headings, which show the normal outline.
178
-
-**The site search box is named "Search documentation" but shows "Search docs".** Voice control users may need to say "Search documentation", or move to the field with Tab ([#266](https://github.com/Community-Access/git-going-with-github/issues/266)).
179
177
-**Some facilitator guides start headings with emoji**, which screen readers read aloud by name, and some code blocks do not say what they contain ([#264](https://github.com/Community-Access/git-going-with-github/issues/264), [#267](https://github.com/Community-Access/git-going-with-github/issues/267), [#268](https://github.com/Community-Access/git-going-with-github/issues/268)). Learner chapters are not affected by the emoji.
180
178
-**The braille files are machine translated.** They are produced automatically by liblouis from a plain-text version of the ePub, so tables are flattened into lines of text and print formatting is not converted to braille formatting. We have no record of review by a certified braille transcriber. Workaround: the ePub, Word or HTML version read with a refreshable braille display keeps the tables and headings.
181
179
-**Podcast episodes are companions, not readings.** Episodes use synthetic voices and summarize a chapter rather than reading it word for word. Every episode has a transcript, and the chapter itself is the complete source.
@@ -191,7 +189,7 @@ We publish accessibility progress here, every quarter and after each cohort, and
191
189
### October 2026: adopting the framework
192
190
193
191
-**Completed:** this document; a reworked [accessibility bug report form](https://github.com/Community-Access/git-going-with-github/issues/new?template=accessibility-bug.yml) with only two required fields and an email alternative; a full accessibility checklist in the pull request template; the documentation accessibility check in CI, with its first findings tracked in [#267](https://github.com/Community-Access/git-going-with-github/issues/267); fixes to a skipped heading level (Appendix Z), a second H1 (Appendix L), empty table headers on the registration pages, and a stray line above the title of CONTRIBUTING.md. Earlier in 2026: an EBAE braille file beside the UEB one ([#174](https://github.com/Community-Access/git-going-with-github/issues/174)), and Chapter 11's explanation of the VoiceOver "selection replaced" announcement ([#175](https://github.com/Community-Access/git-going-with-github/issues/175)).
194
-
-**Remaining:** run and record the [core flow checks](admin/ACCESSIBILITY_CORE_FLOWS.md); fix the site template findings ([#265](https://github.com/Community-Access/git-going-with-github/issues/265), [#266](https://github.com/Community-Access/git-going-with-github/issues/266)); work through the recorded documentation findings ([#264](https://github.com/Community-Access/git-going-with-github/issues/264), [#268](https://github.com/Community-Access/git-going-with-github/issues/268)); find the cause of [#175](https://github.com/Community-Access/git-going-with-github/issues/175).
192
+
-**Remaining:** run and record the [core flow checks](admin/ACCESSIBILITY_CORE_FLOWS.md); work through the recorded documentation findings ([#264](https://github.com/Community-Access/git-going-with-github/issues/264), [#268](https://github.com/Community-Access/git-going-with-github/issues/268)); find the cause of [#175](https://github.com/Community-Access/git-going-with-github/issues/175).
195
193
-**Known barriers:** see [Known limitations](#known-limitations).
196
194
-**How to help:** issues labeled [`accessibility`](https://github.com/Community-Access/git-going-with-github/issues?q=is%3Aopen+label%3Aaccessibility).
<p>These are the barriers we know about, what they mean for you, and what to do instead. Please <ahref="#reporting-accessibility-issues">report any we have missed</a>.</p>
387
387
<ul>
388
388
<li><strong>Website testing is partial.</strong> Keyboard, screen reader and manual visual checks of the website's core tasks 1 to 4 are <ahref="admin/ACCESSIBILITY_CORE_FLOWS.html">recorded</a>, on Windows only. Not yet run: the accessibility bug report form (task 5), the ePub and braille downloads (task 6), VoiceOver on macOS, and Windows High Contrast. The manual check found two barriers: the breadcrumb is cut off at narrow widths and high zoom (<ahref="https://github.com/Community-Access/git-going-with-github/issues/280">#280</a>), and Chapter 05 uses abbreviations without spelling them out (<ahref="https://github.com/Community-Access/git-going-with-github/issues/279">#279</a>). Workaround for the breadcrumb: the same Home link is in the sidebar as "Workshop Home".</li>
389
-
<li><strong>The Quick Jumps links hide their focus outline.</strong> On every chapter page, keyboard focus on the Quick Jumps links shows only an underline and a faint background, which is hard to see with low vision (<ahref="https://github.com/Community-Access/git-going-with-github/issues/265">#265</a>). Workaround: the same links are in the "On this page" list and the page headings, which show the normal outline.</li>
390
-
<li><strong>The site search box is named "Search documentation" but shows "Search docs".</strong> Voice control users may need to say "Search documentation", or move to the field with Tab (<ahref="https://github.com/Community-Access/git-going-with-github/issues/266">#266</a>).</li>
391
389
<li><strong>Some facilitator guides start headings with emoji</strong>, which screen readers read aloud by name, and some code blocks do not say what they contain (<ahref="https://github.com/Community-Access/git-going-with-github/issues/264">#264</a>, <ahref="https://github.com/Community-Access/git-going-with-github/issues/267">#267</a>, <ahref="https://github.com/Community-Access/git-going-with-github/issues/268">#268</a>). Learner chapters are not affected by the emoji.</li>
392
390
<li><strong>The braille files are machine translated.</strong> They are produced automatically by liblouis from a plain-text version of the ePub, so tables are flattened into lines of text and print formatting is not converted to braille formatting. We have no record of review by a certified braille transcriber. Workaround: the ePub, Word or HTML version read with a refreshable braille display keeps the tables and headings.</li>
393
391
<li><strong>Podcast episodes are companions, not readings.</strong> Episodes use synthetic voices and summarize a chapter rather than reading it word for word. Every episode has a transcript, and the chapter itself is the complete source.</li>
<h3id="october-2026-adopting-the-framework">October 2026: adopting the framework</h3>
402
400
<ul>
403
401
<li><strong>Completed:</strong> this document; a reworked <ahref="https://github.com/Community-Access/git-going-with-github/issues/new?template=accessibility-bug.yml">accessibility bug report form</a> with only two required fields and an email alternative; a full accessibility checklist in the pull request template; the documentation accessibility check in CI, with its first findings tracked in <ahref="https://github.com/Community-Access/git-going-with-github/issues/267">#267</a>; fixes to a skipped heading level (Appendix Z), a second H1 (Appendix L), empty table headers on the registration pages, and a stray line above the title of CONTRIBUTING.md. Earlier in 2026: an EBAE braille file beside the UEB one (<ahref="https://github.com/Community-Access/git-going-with-github/issues/174">#174</a>), and Chapter 11's explanation of the VoiceOver "selection replaced" announcement (<ahref="https://github.com/Community-Access/git-going-with-github/issues/175">#175</a>).</li>
404
-
<li><strong>Remaining:</strong> run and record the <ahref="admin/ACCESSIBILITY_CORE_FLOWS.html">core flow checks</a>; fix the site template findings (<ahref="https://github.com/Community-Access/git-going-with-github/issues/265">#265</a>, <ahref="https://github.com/Community-Access/git-going-with-github/issues/266">#266</a>); work through the recorded documentation findings (<ahref="https://github.com/Community-Access/git-going-with-github/issues/264">#264</a>, <ahref="https://github.com/Community-Access/git-going-with-github/issues/268">#268</a>); find the cause of <ahref="https://github.com/Community-Access/git-going-with-github/issues/175">#175</a>.</li>
402
+
<li><strong>Remaining:</strong> run and record the <ahref="admin/ACCESSIBILITY_CORE_FLOWS.html">core flow checks</a>; work through the recorded documentation findings (<ahref="https://github.com/Community-Access/git-going-with-github/issues/264">#264</a>, <ahref="https://github.com/Community-Access/git-going-with-github/issues/268">#268</a>); find the cause of <ahref="https://github.com/Community-Access/git-going-with-github/issues/175">#175</a>.</li>
405
403
<li><strong>Known barriers:</strong> see <ahref="#known-limitations">Known limitations</a>.</li>
406
404
<li><strong>How to help:</strong> issues labeled <ahref="https://github.com/Community-Access/git-going-with-github/issues?q=is%3Aopen+label%3Aaccessibility"><code>accessibility</code></a>.</li>
0 commit comments