Learning patterns/Writing durable documentation

Learning Pattern Library

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='

creator• Harej (WMF)

created on29 June, 2017

status:DRAFT

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.

See also

Related patterns

• Designing portals on wikis