Skip to content

Fix accessibility issues found in a11y review - #207

Open
aarmey wants to merge 1 commit into
mainfrom
a11y-fixes
Open

Fix accessibility issues found in a11y review#207
aarmey wants to merge 1 commit into
mainfrom
a11y-fixes

Conversation

@aarmey

@aarmey aarmey commented Aug 27, 2026

Copy link
Copy Markdown
Member

Summary

  • Icon-only links (GitHub, Home, Mastodon, ORCID, Twitter) now have accessible names via <title> elements in their SVG symbols
  • Nav's home link now reads "Home" instead of "/"; current nav item gets aria-current="page", matched by URL so it's robust to label changes
  • Every page layout now has exactly one <h1>, with subsequent headings renumbered so there are no skipped levels (team, publications, tag archive, contact, research/industry pages all affected)
  • Publication abstract "[Abstract]" toggle is now a real <button> with aria-expanded/aria-controls instead of a bare <a href="#">
  • 404 page now has lang="en-US" like every other page
  • Team page's "Former Members" list is visible by default (previously required JS to show anything), and filter buttons expose their state via aria-pressed

Test plan

  • hugo --minify builds cleanly
  • Verified via built HTML: single <h1> per page, no skipped heading levels
  • Verified GitHub icon symbol now renders with <title>GitHub</title>
  • Verified nav highlights the correct current page (by URL) on team/research/industry/home
  • Verified abstract toggle renders as <button aria-expanded="false" aria-controls="...">
  • Manual screen reader spot-check (not done in this environment)

🤖 Generated with Claude Code

https://claude.ai/code/session_018Ti6piqbtTg9j7XgeDmwCu

…tates

- Add missing <title> elements to icon symbols so icon-only links
  (GitHub, Home, Mastodon, ORCID, Twitter) have accessible names
- Give the homepage nav link a real "Home" label instead of "/"
- Add aria-current="page" to the current nav item, matched by URL
  instead of by title so it survives the label change
- Give every page layout a single <h1> and correct the resulting
  heading order (team, publications, tag, contact, research/industry)
- Convert the publication abstract "[Abstract]" toggle from a bare
  <a href="#"> to a real <button> with aria-expanded/aria-controls
- Add lang="en-US" to the 404 page
- Make the team page's former-members list visible without JS, and
  expose alumni filter state via aria-pressed

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Ti6piqbtTg9j7XgeDmwCu
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