Documentation/Decision records

Decision records help project maintainers understand the thinking behind past decisions.

Quickstart

 * Create a decision record on mediawiki.org (button)
 * Wikitext template
 * Markdown template

Where to publish decision records
The simplest way to publish decision records is all on a single page, in chronological order. If the page gets too long, you can split the decision records into separate pages.

If you use a separate page for each decision record, make sure you maintain a list of decision records in chronological order. For example, in MediaWiki, you can add the date to the title of each page (such as  and transclude a list of subpages using.

You should publish decision records alongside other documentation used by project maintainers. For example:


 * On a wiki at
 * In a code repository at

Example
Draft

Wikimedia examples

 * Categories