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
- Kind
- Rule
- Section
- UI writing
- Group
- Voice
- Bucket
- judgment
- Severity
- note
- Since
- v0.1.0