Vague headings
- Forbidden
- "Location", "Check-in", "Parking"
- Instead
- "Beautiful waterfront location", "Fast check-in experience", "Free secure parking"
What this rule looks like
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