Comment on page
Use Markdown Architectural Decision Records
- Status: accepted
- Deciders: devs, devops
- Date: 01.06.2020
We want to record architectural decisions made in this project. Which format and structure should these records follow?
- Formless - No conventions for file format and structure
Chosen option: "MADR 2.1.0", because
- Implicit assumptions should be made explicit.Design documentation is important to enable people understanding the decisions later on.
- The MADR format is lean and fits our development style.
- The MADR structure is comprehensible and facilitates usage & maintenance.
- The MADR project is vivid.
- Version 2.1.0 is the latest one available when starting to document ADRs.
Last modified 3mo ago