View on GitHub


Markdown Architectural Decision Records

Use names as identifier

Context and Problem Statement

An option is listed at “Considered Options” and repeated at “Pros and Cons of the Options”. Finally, the chosen option is stated at “Decision Outcome”.

Decision Drivers

Considered Options

Decision Outcome

Chosen option: “Assign an identifier to an option”, because 1) there is no markdown standard for identifiers, 2) the document is harder to read if there are multiple options.