Skip to content
GitHub
Sections

Reference · Things to avoid

A kicker above every heading

Forbidden
A small uppercase, letter-spaced line over each section heading: "FEATURES" over "What you get", "HOW IT WORKS" over "Three steps to launch"
Instead
One heading that says it. If the kicker repeats the heading, delete it; if it adds something, work those words into the heading or the line under it.

What this rule looks like

Forbidden
Instead

Why this rule

A kicker is one more line to read before the one that matters, and on every section it stops marking anything. It survives from print, where a section label helped a reader flip to a page. On a screen the heading is already the label.

Kind
Rule
Section
Things to avoid
Group
Generic-AI aesthetic
Bucket
hybrid
Severity
warning
Detector
heading-kicker
Since
v0.17.0

Read as plain text