Tip 1: Start with the Headline

Not everyone reads the full document. Put the most important information first — a summary or introduction that delivers 80% of the meaning to 80% of readers.

Tip 2: Abstract to Specific

Structure documents from problem/context → solution overview → detailed components. Readers build context progressively.

Example: First describe the high-level architecture (3 numbered steps), then detail each step in its own section.

Tip 3: Explain the Same Thing Three Times

Technical concepts are hard to convey. Reduce ambiguity by explaining the same idea in multiple formats:

• Prose paragraph describing the flow
• Numbered/bulleted list of steps
• Component diagram showing architecture
• Sequence diagram showing interactions

Each format reaches different readers and reinforces understanding from different angles.