Documentation has to be:
- simple to read and understand
- simple to create and maintain.
The best way to achieve this is to keep it minimal. So, make documentation straightforward.
- Be directive: focus on what has been proven functional.
- Redirect information to the right communication channel: redirect readers to external ressources.