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.