Skip to content
GitHub
Sections

Reference · UI writing

Vague headings

Forbidden
"Location", "Check-in", "Parking"
Instead
"Beautiful waterfront location", "Fast check-in experience", "Free secure parking"

What this rule looks like

Forbidden
Instead

Why this rule

A heading must carry its own meaning. People scan headings and skip the supporting text, and screen reader users routinely pull up a list of every heading on a page to navigate — a list of one-word labels tells them nothing. Break long passages into groups with a descriptive heading each, rather than one unbroken block. The same holds for a page's headline. "Build the future of work", "Your all-in-one platform", "Where ideas come to life" could sit above any product, which means they say nothing about this one. A headline names what the product does and for whom: "Search your logs by asking in plain English". If it would still be true after swapping in a competitor's name, rewrite it.

Kind
Rule
Section
UI writing
Group
Structure
Bucket
judgment
Severity
note
Since
v0.1.0

Read as plain text