Skip to content
GitHub
Sections

Reference · UI writing

Vague or inflated language

Forbidden
"Utilise", "leverage", "seamlessly", "Custom domains are the bee's knees"
Instead
Write as if talking to a capable person unfamiliar with the topic. Short words over long ones. No jargon, no slang, no technical vocabulary the reader has not been given. Contractions are good — "you're", "they're", "who's" — they read as speech rather than documentation.

What this rule looks like

Forbidden
Instead
Kind
Rule
Section
UI writing
Group
Voice
Bucket
judgment
Severity
note
Since
v0.1.0

Read as plain text