All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
- Disable markdown-lint's MD013 - line length for the ADR files.
2.1.2 – 2019-02-17
- Add more status fields. Source: #20.
- Fixed typos in
README.md
.
2.1.1 – 2019-01-21
- Fix typo in heading. Fixes #18
2.1.0 – 2018-06-14
- Headings "Positive/negative consequences" now full h3 headings instead of text headings
- Adapted internal ADRs to new format
- Added ADR-0011 stating that we use an asterisk as list marker
2.0.3 – 2018-03-21
- Fix reference to MADR version in ADR-0000 and README.md
2.0.2 – 2018-03-16
- Streamlined template's ADR-0000.
- Streamlined template by using ellipsis and removing double empty lines.
2.0.1 – 2018-03-07
- State MADR 2.0.1 also in template's ADR-0000.
2.0.0 – 2018-03-07
- Optional: Status, Deciders, Date. Fixes #2.
- More explanations of options can now be put next to each option
- Links to other ADRs added at the bottom of the ADR
- Rename "User Story" to "Technical Story"
- "Context and Problem Statement" and "Decision Drivers" are a heading now
- The chosen option is now written in quotes to separate the name from the rest of the text
- All bullet lists are now made using
*
(instead of-
at some lists)
1.4.0 – 2018-03-01
- Version of MADR into ADR-0000 of the template. Fixes #5
README.md
: Added wints on the filenames.- More ADRs on MADR
- Added
LICENSE
file
README.md
: Removed section "Background Information" as the information is contained at http://adr.github.io, too. Fixes #4
1.3.1 – 2018-02-13
- Replace "alternative" by "option" in all
md
files - Update to new "Decision Outcome" format in all
md
files
1.3.0 – 2018-01-30
- Changed template to be closer to the Y-Statements. Especially rename "alternative" to "option".
- Restructured syntax of "Decision Outcome". Positive and negative consequences as separate bullet list.
- Rename "point" to "argument" (which reverts the change of version 1.2.0)
- Number "arguments" from a to c. Re-use "variables" a to c to guide the author that the same topic should be handled by the enumeration. e..g, performance, ...
- Exchange
+
and-
by "Good, because ..." and "Bad, because ..." - Remove emphasize of "User Story:"
1.2.0 – 2018-01-26
- Add installation instructions using
npm
.
- Placeholders changed from
*[PLACEHOLDER]*
to[PLACEHOLDER]
to have a single pair of enclosing characters ([]
) instead of two (*[]*
). - Rename
argument 1 pro
topro point
andargument 1 con
tocon point
1.1.1 – 2017-12-05
- Simplify
package.json
and fix name.
1.1.0 – 2017-12-04
- No change in the template itself.
- Use adr-log to generate links to the ADRs in
docs/adr/index.md
. template.md
is not part of the log, but a separate text block indocs/adr/index.md
.- Link to new homepage of MADR: https://adr.github.io/madr/.
- Refined justification of ADR-0000.
- Refined
README.md
.
- Fixed internal links in
docs/adr/index.md
. - Fixed typo in
docs/adr/0000-use-markdown-architectural-decision-records.md
.
1.0.0 – 2017-09-09
First release of Markdown Architectural Decision Records.