Skip to content

Fix heading structure, video iframe titles and footer link underlines - #586

Open
julien-deramond wants to merge 2 commits into
mainfrom
apply-accessibility-wcag-2-2-audit-of-th
Open

julien-deramond wants to merge 2 commits into
mainfrom
apply-accessibility-wcag-2-2-audit-of-th

Conversation

@julien-deramond

Copy link
Copy Markdown
Member

Adds an h1 to the archive and videos pages (visually hidden, so the layout doesn't change), turns the archive year headings into h2, gives each video iframe on /videos/ a title naming its post instead of the identical "YouTube Video", and underlines the links in the footer's running text so they don't rely on colour alone (WCAG 1.4.1).

What was done

  • src/pages/archive.astro: <h1 class="visually-hidden">Archive</h1>; year <h3> becomes <h2 class="h3"> (same look).
  • src/pages/videos.astro: <h1 class="visually-hidden">Videos</h1>; iframe title is Video: <post title>.
  • src/components/footer/Footer.astro + src/assets/scss/_footer.scss: the slot list gets bd-footer-note, and links in it are underlined. The shared footer's column links keep their current style.
  • Choice: hidden h1 rather than a visible heading, to keep the current design; a visible title would be the alternative.
  • Not touched (not blog code): link contrast in light mode, dark code comment contrast, footer h5 heading order (@twbs/bui, Bootstrap 6).
  • npm test passes (build, eslint, stylelint, markdownlint, linkinator, lockfile-lint). Built HTML has one h1 on each page. Not checked in a browser or with a screen reader.

How to review

  • Decide: hidden h1 on archive and videos; keep it, or ask for a visible page title.
  • Try it: npm ci && npm start, open http://localhost:4000/archive/ and /videos/ (look unchanged), scroll to the footer and check the four links are underlined in light and dark.

🤖 Generated with Claude Code

@julien-deramond
julien-deramond requested a review from mdo October 8, 2026 19:15

// Links inside running text must not rely on colour alone (WCAG 1.4.1)
.bd-footer-note a {
text-decoration: underline;

@julien-deramond julien-deramond Oct 8, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Requested the review to you @mdo’s review on this modification to have your opinion on the design side of it.

From a pure a11y perspective, I think this approach would be better. However, it would also change the rendering of the blog footer. I could backport this change (or an alternative solution) to the other sites as well.

In this PR:

Image

On the main website:

Image

Maybe we could just keep the underline and tweak it slightly (reduce the gap, adjust the color, etc.).

If we don't want this change, we can simply revert this part and keep the other a11y improvements.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Late to this sorry! Yeah lets reduce the underline opacity to like 50 for default, then full on hover.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done at https://deploy-preview-586--bootstrapblog.netlify.app/. But maybe on hover you wanted to keep the gray/black/dark color instead of blue.

@julien-deramond
julien-deramond force-pushed the apply-accessibility-wcag-2-2-audit-of-th branch from 8c05903 to 7cafc4d Compare October 10, 2026 19:25
@julien-deramond
julien-deramond force-pushed the apply-accessibility-wcag-2-2-audit-of-th branch from 7cafc4d to 5c9bd34 Compare October 23, 2026 08:00
@mdo
mdo force-pushed the apply-accessibility-wcag-2-2-audit-of-th branch from a3f58d3 to 5fe0d73 Compare October 26, 2026 16:47
@julien-deramond
julien-deramond force-pushed the apply-accessibility-wcag-2-2-audit-of-th branch from e8636d5 to a49509c Compare October 27, 2026 06:32
julien-deramond and others added 2 commits November 1, 2026 14:57
Add an h1 to the archive and videos pages, make the archive year headings h2,
give each video iframe a title naming its post, and underline the links in the
footer's running text so they don't rely on colour alone.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@julien-deramond
julien-deramond force-pushed the apply-accessibility-wcag-2-2-audit-of-th branch from a49509c to b8d7863 Compare November 1, 2026 13:58

This branch has not been deployed

No deployments
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.

2 participants