gabrielmoreira Audience-Aware Communication
Before writing, consider who will read this.
Questions to ask:
- Expert or beginner? Use jargon only if the audience knows it.
- Needs to act or just understand? Action-oriented writing uses imperative mood.
- Reading for reference or scanning? Use headers, bullets, and code blocks.
Adaptation rules:
- Beginners: define terms, use analogies, avoid acronyms.
- Experts: skip basics, link to references, focus on the non-obvious.
- Mixed audience: lead with the executive summary, put details in sections.
Anti-pattern: Writing at your own knowledge level without adjusting for the reader.