Learning patterns/Writing durable documentation
Jump to navigation Jump to search
created on29 June, 2017
What problem does this solve?
Documentation allows you to preserve what you know and pass it to other people. You should write as much documentation as possible.
What is the solution?
- Avoid template-heavy designs: they create a maintenance burden in the long term.
- Consolidate around a few pages. Do not create three tiny pages when you can create one medium-sized page.
- Don't make pages overly long. This contradicts the above but it is important to find balance.