3 ms·
1. Start by making it easier to learn whom to talk to. This requires that you accept that the very thing you are frustrated by is in fact fundamental to the va
by afarrell 6y ago
1. Start by making it easier to learn whom to talk to.
This requires that you accept that the very thing you are frustrated by is in fact fundamental to the value delivered. The purpose of documentation is to aid conversations.
2. Make life easier for the people whom most people have to go talk to.
3. By default, documentation goes stale over time, so keep the number of docs that are expected to be up-to-date to a minimum.
Make it so that most docs have a clear timestamp and context so that people don't have to wonder if it is out-of-date or not. One example of this is https://adr.github.io/ https://adr.github.io/