MADR is a lean template to capture any decisions in a structured way. The template originated from capturing architectural decisions and developed to a template allowing to capture any decisions taken. MADR is a template allowing to craft short, medium-sized, and large decision records. There is no formal definition of short, medium-sized, and large decision records. The following sections present an example in the context of assertion frameworks for Java. We start with presenting a very short and dense version: It “just” lists the context and problem statement, the available options, and the outcome. For some decisions, these bits of information could not be enough. Therfore, it is possible to “unpack” the decision. This is done in the presented longer version of the ADR.
Features
- MADR follows Semantic Versioning 2.0.0 and documents changes
- For rendedring the docs directory, Jekyll is needed
- For local development, follow the Jekyll installation instructions
- On Windows, using a dockerized environment is recommended
- This work is dual-licensed under MIT and CC0
- Includes examples
Project Samples
