Understand the audience

Understanding the reader of your writing documentation:

• What does the reader bring to the table? What context do they have that equips them to understand the context?
• Why is the reader reading your documnetation? What problems are they trying to solve?

Identify the target audience at the beginning of your documentation so readers can confirm reading it is worth their time (also remind the required knowledge and share links to introductory resources or summary that).

New terms should be emphasized (bold) with description in footer or appedix.

"Bias towards simple over clever"