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, ordered chronologically by date of acceptance. 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 (or your content management system) maintain a chronologically-sorted list of decision records. For example, by adding a number to the page title or filename, such as  or.

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