Skip to content

Latest commit

 

History

History
21 lines (16 loc) · 1.15 KB

0000-use-markdown-architectural-decision-records.md

File metadata and controls

21 lines (16 loc) · 1.15 KB

Use Markdown Architectural Decision Records

Should we record the architectural decisions made in this project? And if we do, how to structure these recordings?

Considered Options

Decision Outcome

Chosen option: MADR 1.4.0, because:

  • Implicit assumptions should be made explicit. Design documentation is important to enable people understanding the decisions later on. See also A rational design process: How and why to fake it.
  • The MADR template is lean and fits our development style.
  • Version 1.4.0 is the latest one available when starting to document ADRs.