Skip to content

Fail an empty alt in htmlproofer; aria-current=location on a post's section - #106

Merged
bits-bytes-nn merged 1 commit into
mainfrom
review-r13
Oct 16, 2026
Merged

bits-bytes-nn merged 1 commit into
mainfrom
review-r13

Conversation

@bits-bytes-nn

Copy link
Copy Markdown
Owner

Fourth round of adversarial review.

  • htmlproofer now runs with --no-ignore-empty-alt in CI (and in the README/CLAUDE.md gate commands). An image written as ![](/assets/images/x.png) renders alt="", which htmlproofer ignores by default, so a figure a screen reader skips, and whose lightbox has no caption, shipped with all gates green (verified on a scratch copy). No current page has an empty alt, so the flag passes today.
  • js/main.js: on a post, its section's nav link gets aria-current="location" rather than "page"; the exact page keeps "page".
  • docs/tech-doc.md: the reduced-motion block removes animations, transitions and smooth scrolling; it did not "neutralise" hover transforms as the text said.

No change to _data/post_conventions.yml and no new lint rule.

Checks: all five gates pass on a fresh build, htmlproofer with the new flag.

…ection

`![](...)` renders alt="", which htmlproofer ignores by default: a screen
reader skips the figure and the lightbox loses its caption, with every gate
green. CI, README and CLAUDE.md now pass --no-ignore-empty-alt; no current
page has an empty alt.

On a post the section's nav link is where the reader is, not the page itself.
@bits-bytes-nn
bits-bytes-nn merged commit 3c0b753 into main Oct 16, 2026
3 checks passed
@bits-bytes-nn
bits-bytes-nn deleted the review-r13 branch October 16, 2026 15:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant