Decisions

Below, all decision records for MADR are listed. This list uses the TOC functionality of the Just the Docs Jekyll template.

For new ADRs, please use adr-template.md as basis. More information on MADR is available at https://adr.github.io/madr/. General information about architectural decision records is available at https://adr.github.io/.

---

Table of contents

• Use Markdown Architectural Decision Records
• Dual License the Work
• Do Not Use Numbers in Headings
• Write Own MADR Tooling
• Write Own TOC Tool
• Use Dashes in Filenames
• Use Names as Identifier
• Do Not Emphasize Line Headings
• Add Status Field
• Support Links To Other ADRs Inside an ADR
• Support Categories
• Use Asterisk as List Marker
• Use Curly Braces to Denote Placeholders
• Use YAML front matter for metadata
• Allow “neutral” arguments
• Include “Consulted” and “Informed” of RACI
• Outcome before Detailed Pros and Cons
• Use Same Format for Outcomes and Options
• Use “Confirmation” as Heading
• ADR Template