Accessibility content sweep: media titles, video aria-labels, image alt text (#110)#112
Merged
Conversation
jonfroehlich
added
content
Fix 103 mechanically-detectable accessibility issues across 16 published pages: add descriptive `title=` to YouTube `<iframe>`s, `aria-label` to `<video>` heroes, and alt text to images with empty alt. Text describes the actual media (derived from each page's context/captions), not placeholders. Exemplar modules (communication, esp32) were already clean. Content-only: enforcement is deferred to a pa11y-ci CI gate in a follow-up (off-the-shelf, axe-core based) rather than a bespoke checker. Part of #110. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
jonfroehlich
force-pushed
the
feat/a11y-sweep
branch
from
4d6fad1 to
cf2ed25
Compare
jonfroehlich
changed the title
Document that it is NOT a CI gate and must not be wired into content-lint.yml; accessibility enforcement is moving to off-the-shelf pa11y-ci (axe-core). Kept only as a fast dependency-free local audit; deletable once pa11y-ci lands (#110). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
4 tasks
Decided to standardize on the Jekyll-native html-proofer gem for content QA (missing alt + broken links + HTML validity, no new toolchain) rather than a Node/Chromium pa11y stack. Update the deprecation notes accordingly (#110). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Accessibility content sweep (V2.0 item D) fixing 103 mechanically-detectable a11y issues across 16 published pages.
title)aria-label)The exemplar modules (
communication,esp32) were already clean.How
Surgical edits: each change adds only the missing
title=/aria-labelattribute or alt text on the flagged element — no reformatting (101 lines changed, 1:1). Text describes the actual media using each page's surrounding context and captions (e.g. "A potentiometer's raw analog input oscillating between 142 and 143 while untouched, with the noise removed by a moving average filter"), not generic placeholders.Enforcement → html-proofer (follow-up, not this PR)
The content-QA gate will be a follow-up using the off-the-shelf, Jekyll-native
html-proofergem — run against the built_site/it flags missing imagealt, broken links, and malformed HTML, with no new toolchain (Ruby is already in the stack). Tracked in #110.scripts/check_a11y.pyis included only as a deprecated, local-only spot-check (the audit that found these 103 issues). It is explicitly not wired into CI and is documented as such in its docstring andscripts/README.md; it will be deleted once html-proofer lands.Verification
Full
bundle exec jekyll buildsucceeds (no errors); spot-checked the rendered_site/HTML to confirm the newtitle=/aria-label/alt=attributes emit correctly.Out of scope
Color-only wiring/circuit instructions (not auto-detectable) are tracked in #111.
Part of #110.
🤖 Generated with Claude Code