Skip to content
GitHub
Sections

Reference · UI writing

Structure imposed rather than earned

Forbidden
Overview, Key benefits, Challenges, Best practices, Conclusion, whatever the subject. A heading every two paragraphs. Every bullet opening with a bold phrase. A numbered list for things with no order.
Instead
Let the content decide the structure: a heading where a reader would look for one, a numbered list for a sequence, bold only where a reader scanning must stop.

What this rule looks like

Forbidden
Instead
Kind
Rule
Section
UI writing
Group
Prose
Bucket
judgment
Severity
note
Since
v0.23.0

Read as plain text