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”.
- Easy to read
- Easy to write
- Avoid copy and paste errors
- Repeat all option names if they occur
- Assign an identifier to an option, e.g.,
[A] Use gradle as build tool
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.