Heading structure · Playbook
Heading structure — local fallback
heading-structure tells you what is wrong with the outline. The detailed, current standards — per-finding fixes — live in the team wiki (set OUTLINE + OUTLINE_API_URL and the report links them). This is the minimal fallback.
- No H1 — every indexable page needs exactly one H1 that states the primary topic.
- Multiple H1s — keep the first, demote extras to H2 (or H3 if inside a subsection).
- Skipped levels — never jump H1→H3; step by one (H1→H2→H3). The proposal demotes the too-deep heading.
- Empty headings — remove headings with no visible text — they break screen-reader navigation.
- Duplicate headings — triplicate+ identical text is noise; reword to distinguish sections.