Define a target audience and what they will learn from your document.
Position your documents relative to the overall system.
Possible contexts are:
Write as formal as necessary and not a bit more.
Technical contracts between systems (web services, libraries) and technical designs require formality. All other documents typically benefit from simple, informal writing.
Chose a medium/tool appropriate to the content, audience and formality.
Examples of the Right™️ Medium