0000. Option1 vs Option2
Date: YYYY-MM-DD
Status: Proposed
Deciders: [List everyone involved in the decision]
Tags: [Relevant tags like [arcana-bot], [mercury-bot], etc]
Context
Describe the context and problem statement, e.g.:
- What options are being compared and why?
- What is the background information needed to understand this decision?
- What are the key requirements or constraints?
Decision
Describe the chosen option and reasoning:
- Which option was chosen?
- What are the key technical details?
- Why was this option chosen over the alternative?
- What were the key deciding factors?
Consequences
Positive
- [Benefits of the chosen option]
- [Advantages over the alternative]
- ...
Negative
- [Drawbacks of the chosen option]
- [What we give up by not choosing the alternative]
- ...
Neutral
- [Implementation considerations]
- [Migration or transition needs]
- [Documentation requirements]
- ...
References
- Links to relevant documentation
- Links to related PRs or issues
- External references that helped inform the decision