Skip to content
GitHub
Sections

Reference · Things to avoid

Numbered section labels

Forbidden
"01", "02", "03" in small type beside section headings that are not a sequence
Instead
Number only a real order: steps to follow, a ranking, a procedure. Anything else keeps its heading and no number.

What this rule looks like

Forbidden
Instead

Why this rule

A number promises an order. A reader told there are three steps looks for what comes after the third, and a page that numbers its sections only because they are sections has promised something it does not deliver.

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

Read as plain text