Document a possible option for an architecture decision. Choose this document type to describe the alternative for a decision in more detail. This is typically a subpage of an architecture decision document.
Provides a detailed description of an alternative solution to a problem. It shows what has been evaluated and why this alternative has not been selected as the solution for a particular problem.
The alternative document is usually a subdocument to a decision document. It is not collected on its own homepage.
The document type architecture alternative provides the following properties:
Please note that only information about specific properties is provided here. Common document property used by all document types are documented by Document Properties.
Describe the alternative without evaluating it in the context of the problem.
Provide an evaluation how the problem would have been solved with this alternative. This could provide a list of pros and cons.
Reason for Denial
Document the exact reason why this alternative has been rejected.
Divide complex alternatives into their components.
The Architecture Decision document explains why a particular option has been selected. The alternative document allows to store information about alternatives and why they have been not be viewed as proper solutions. Please make sure that the information in this documents are really relevant for later reviews. Otherwise keep them as short as possible.