Structure imposed rather than earned
- Forbidden
- Overview, Key benefits, Challenges, Best practices, Conclusion, whatever the subject. A heading every two paragraphs. Every bullet opening with a bold phrase. A numbered list for things with no order.
- Instead
- Let the content decide the structure: a heading where a reader would look for one, a numbered list for a sequence, bold only where a reader scanning must stop.
What this rule looks like
- Kind
- Rule
- Section
- UI writing
- Group
- Prose
- Bucket
- judgment
- Severity
- note
- Since
- v0.23.0