Learning patterns/Writing durable documentation

Writing durable documentation
problemin a sentence, please describe the problem this pattern addresses after 'problem='
solutionin a sentence, please summarize the solution this pattern provides after 'solution='
creatorHarej (WMF)
created on29 June, 2017

What problem does this solve?Edit

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?Edit

  • 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.

Things to considerEdit

When to useEdit

See alsoEdit

Related patternsEdit

External linksEdit