directus / directus/docs

Heading level skips (e.g. H2 to H4 without H3) WAI/WCAG violations

Open
#825 1 comment 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.