Headings make a specific point
Write headings that make the product's point, not labels like "Features" or "FAQ".
Draft — not yet reviewed by a maintainer
Why it matters
A category label tells people what kind of section they are in, which they can already see. A specific heading tells them why to keep reading and still makes sense out of context.
How to check it
Swap in another product's name: if the heading still works, rewrite it.
The default it guards against
"Features", "Why choose us?", "Frequently Asked Questions" and "Everything you need to succeed".
Library items that apply it
Where it comes from
- AGENTS.md §13, v1.1 (tag v1.1-archive): no generic AI filler copy
- Review dimension: task fit (docs/quality-gates.md)
Repository paths refer to the Tessli repository ; WCAG references are to WCAG 2.2.