Heading level skips (e.g. H2 to H4 without H3) WAI/WCAG violations
- Dominant language
- TypeScript
- Stars
- 22
- Forks
- 82
- Avg merge
- 18h 49m
- Merged PRs (30d)
- 4
Description
https://www.w3.org/WAI/tutorials/page-structure/headings/
> Skipping heading ranks can be confusing and should be avoided where possible: Make sure that a \ is not followed directly by an \, for example. It is ok to skip ranks when closing subsections, for instance, a \ beginning a new section, can follow an \ as it closes the previous section.
Asked my 🤖 buddy Claude to sweep for them after manually finding #824
Contributor guide
Research direction
Start by reading the linked WAI heading guidance, then sweep the documentation for heading-rank transitions such as H2 directly to H4. Review each reported occurrence in context, preserving valid skips when closing subsections. Done means the documented pages no longer contain avoidable heading-level skips.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100