Stop documenting heading eyebrows

ADR-046 decides that an eyebrow is a paragraph directly before the headline, never a heading. The docs still teach the heading form. The guide's only example of it uses hero, which renders it wrongly (BUG-047), and nineteen rune pages say "a short paragraph or heading" in the same boilerplate sentence.

The native page-section runes keep their grammar until each one is composed (ADR-046, decision 4), so some of them still accept the heading form. The docs stop recommending it anyway: it is not the direction, and documenting less than a rune accepts is safe where documenting more is not.

main View source

Criteria completion

Tracking started Oct 29 — check back for trends.

Relationships

ID:ADR-046Status:accepted

Section's header grammar is anchored and explicit

Date:2026-10-23

ID:BUG-047Status:confirmed

Hero and feature drop a second leading heading and everything after it

Severity:major

ID:WORK-656Status:done

The eyebrow is a section role, and its linked pill moves into the sections dimension

Priority:mediumComplexity:moderateMilestone:v0.43.0

ID:SPEC-160Status:accepted

Section is the composition base; card is a section with a surface

ID:v0.44.0Status:planning

v0.44.0 — Hero, cta and testimonial compose

main current done

claude/value-primitives-and-grid done main done claude/milestone-v0-44-0-ism7ni done claude/post-v0.43-roadmap-mf1ngx ready

Acceptance Criteria

The "Heading eyebrow + headline" section of site/content/docs/authoring/page-sections.md is removed, and the guide says an eyebrow is a short paragraph directly before the headline
The boilerplate sentence on every rune page that links to page sections says "a short paragraph", not "a short paragraph or heading" (nineteen pages, found with grep -rn "paragraph or heading" site/content)
No page under site/content describes or shows two leading headings as an eyebrow and a headline
npm run format:md:check passes

Approach

Text-only. The nineteen pages share one sentence; change "Place a short paragraph or heading before …" to "Place a short paragraph before …" in each, keeping the rest of each sentence as it is. In the guide, delete the section and its example, and add one sentence to "Paragraph eyebrow

headline" saying a heading is never read as an eyebrow.

This fits beside WORK-656, which makes the eyebrow a section role and also touches the eyebrow docs, but it does not depend on it.

References

ADR-046: the resolved open question.
SPEC-160: D7, no heading eyebrow in the composed hero and cta.
BUG-047: the documented example renders wrongly today.

Resolution

Completed: 2026-10-29

Branch: claude/milestone-v0-44-0-ism7ni

What was done

site/content/docs/authoring/page-sections.md: removed "Heading eyebrow + headline" and its example; added that a heading is never read as an eyebrow.
Nineteen rune pages: "a short paragraph or heading before" → "a short paragraph before".
site/content/extend/rune-authoring/patterns.md: the eyebrow is a paragraph directly before the main heading, not the first of two headings.