Long text without a structure
- Forbidden
- A run of text with no ordering — context first, the conclusion buried in the middle, and the thing the reader has to do somewhere near the end.
- Instead
- For anything longer than a sentence, use the inverted pyramid: most important information first, supporting detail next, background last.
What this rule looks like
Why this rule
| Layer | Goes in |
|---|---|
| Most important | The heading — enough on its own to complete the task |
| Supporting | The paragraph beneath, for those who need more |
| Background | A separate screen or a disclosure (P-11) |
Someone who reads only the heading still gets the point. Someone who needs the detail can find it. Nobody is made to read background information to reach the action.
- Kind
- Rule
- Section
- UI writing
- Group
- Structure
- Bucket
- judgment
- Severity
- note
- Since
- v0.1.0