Vague headings
==============

Rule · bucket: judgment · severity: note · detector: none · since: v0.1.0
Section: UI writing
Group: Structure

Forbidden:
  "Location", "Check-in", "Parking"

Instead:
  "Beautiful waterfront location", "Fast check-in experience", "Free secure parking"

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.