0001: Record decisions using MADR
Proposed | 14 June 2023 | Lawrence Goldstien
Context and Problem Statement
We must record decisions that have an impact on the delivery of software projects. Decisions must be recorded in a consistent style, allowing team members to understand the reasons behind a decision and the wider consequences.
Considered Options
- MADR - Markdown Any Decision Records
- ADR Tools - Nat Pryce's ADR Tools
- Nygard's ADR - The original ADR
Decision Outcome
Chosen option: "MADR - Markdown Any Decision Records", because it allows for recording contextual information, has a straightforward template format, and optional fields should a decision only require a light touch explainer.
Architecture decision records shall be created with the A prefix: i.e.: "A0001: Record decisions using MADR".
Consequences
A template has been created and documentation added explaining the reason for decision records and how to record them.
Work in Progress!
This site is a work in progress and any opinions contained here are intended to spark discussion within each discipline's community of practice.
Created: 2023-06-23