Skip to content

📚 Documentation: Heading levels in menu should be h2s [a11y][TheA11y100] #279

Closed
@GrahamTheDevRel

Description

@GrahamTheDevRel

Issue

All headings in the left navigation should be changed to <h2>s.

Ideally these would come after an <h1> but due to current page design it is acceptable compromise to have them come before as a quick fix for now.

side nav with a heading highlighted, console showing elements pane indicating it is a <h4>

Why it matters

People using assistive technology rely on proper headings structure to navigate effectively. By skipping levels people can get lost or miss entire sections of content using assistive tech.

Suggested fix

All headings in the left navigation should be changed to <h2>s.

Relevant Success Criterion WCAG

Info and Relationships in WCAG
Technique using heading levels

Additional Notes

Ideal First issue.

Found on stream on 2023-10-25

👀 Have you spent some time to check if this issue has been raised before?

  • I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationgood first issueGood for newcomers

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions