Layer your communication

"Structure your documentation to accomodate the different levels of investment with which readers will approach it"

Each readers has their own ways to read your document (from beginning to end, skimming and dive deeper into the interesting section ...), organize your document will help them:

• Use headings and subheadings liberally
• Add TOC to orient the reader with hyperlink for sections of the document (whenever possible)
• Keep paragraphs short; avoid "wall of text"