A claim with no source

Forbidden: "Teams using Acme ship 37% faster." "A 2024 Stanford study found…" A feature described that the product does not have.
Instead: Every figure, study, quotation, date and feature a page states traces to something in the project: its data, its docs, a link to the source, the product itself. Otherwise it is cut, or written as what it is: "in our own use", "we expect".

What this rule looks like

Forbidden

Instead

Why this rule

A made-up figure reads exactly like a real one, and it is the claim a reader is most likely to repeat. Of everything here, it costs the most when it is wrong.

Kind: Rule
Section: UI writing
Group: Prose
Bucket: judgment
Severity: warning
Since: v0.23.0

Read as plain text