#1 Determine Target Audience

<aside> 💡 Define a target audience and what they will learn from your document.

</aside>

• Who am I writing for?
• What problems are they trying to solve?

#2 Put it in Context

<aside> 💡 Position your documents relative to the overall system.

</aside>

Possible contexts are:

• Other systems
• Users
• Stakeholders
• Competitors
• Geographies

#3 Be formal, if you must

<aside> 💡 Write as formal as necessary and not a bit more.

</aside>

Technical contracts between systems (web services, libraries) and technical designs require formality. All other documents typically benefit from simple, informal writing.

#4 Chose the Right™️ Medium

<aside> 💡 Chose a medium/tool appropriate to the content, audience and formality.

</aside>

Examples of the Right™️ Medium

#5 Version the document if necessary