Add accessibility docs

[Mobey-eth]

Summary

• add a dedicated accessibility guide to the documentation
• cover semantic structure, skip links, form labels, image alternatives, focus styles, and ARIA usage
• link the new guide from the docs table of contents and HTML docs

Validation

• npx prettier --check docs/accessibility.md docs/TOC.md docs/html.md
• npm test

Closes #3038.

[roblarsen]

Great start on this! Since HTML5 Boilerplate is often a first stop for developers, I think we should aim for this guide to be 'A11y 101.'

Currently, the section on ARIA assumes the reader already knows what it is and when to use it. Define it before mentioning it. I'd also suggest moving the complex ARIA examples to the end (or better yet, removing them entirely) and focusing first on the basics already present in the Boilerplate, like the lang attribute and the .visually-hidden class.

[Mobey-eth]

Hi, thanks for the insights. I'll update my PR with your suggestions!

…

On Wed, Apr 22, 2026 at 9:36 PM Rob Larsen ***@***.***> wrote: ***@***.**** requested changes on this pull request. ------------------------------ In docs/accessibility.md <#3410?email_source=notifications&email_token=AXNBFS7HBQC35WOZSIQ3HIL4XEUNXA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTIMJVG43TQNZYHE22M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K64DSL5ZGK5TJMV3V6Y3MNFRWW#discussion_r3126767280> : > @@ -0,0 +1,108 @@ +[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation Great start on this! Since HTML5 Boilerplate is often a first stop for developers, I think we should aim for this guide to be 'A11y 101.' Currently, the section on ARIA assumes the reader already knows what it is and when to use it. Define it before mentioning it. I'd also suggest moving the complex ARIA examples to the end (or better yet, removing them entirely) and focusing first on the basics already present in the Boilerplate, like the lang attribute and the .visually-hidden class. — Reply to this email directly, view it on GitHub <#3410?email_source=notifications&email_token=AXNBFSZOXFYT2MZ3XQUMU3D4XEUNXA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTIMJVG43TQNZYHE22M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2L24DSL5ZGK5TJMV3V63TPORUWM2LDMF2GS33OONPWG3DJMNVQ#pullrequestreview-4157787895>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AXNBFSZTMA64IXSLVTKYYK34XEUNXAVCNFSM6AAAAACYCBJHDOVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHM2DCNJXG44DOOBZGU> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[Mobey-eth]

Updated this to keep it more introductory. I moved the guide toward the basics already in the Boilerplate, added a plain definition of ARIA, and removed the more advanced examples.