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: “Repeat all option names if they occur”, because 1) there is no markdown standard for identifiers, 2) the document is harder to read if there are multiple options which must be remembered.