toolkit

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.