Make a List of the Architectural Decisions
Document your architectural decisions and reasoning
The purpose of an Architectural Decisions List is to document your architectural discussions and outline the reasoning for the decisions taken. Detail the architectural decisions you have chosen for realizing the target architecture.
GOAL
Document the reasoning for the decisions taken
PARTICIPANTS
Enterprise Architects
TIME NEEDED
Ongoing throughout project
PHASE
Design
Before You Start
You can use input from the following artifacts
Materials You Will Need
Resources for Download
Steps
Making a list of the architectural decisions includes several steps. We recommend completing them in one session.
Write Down the Reasoning Behind Your Decisions
Every time you consider two or more alternatives in the architecture, you should remind yourself to write down the reasoning behind your decision for one of the alternatives.
See Completed Example
Throughout the creation of your architecture, you make different decisions. For example, you decide to use one Solution Building Block from vendor A instead of an alternative from vendor B.
Note Down the Reason Why You Have Chosen One of the Options
Was it due to corporate strategy? Maybe there is a corresponding architecture principle that you considered during the decision? You can also include a SWOT analysis to explain the reasoning of your decision.
Or, you decide to implement a required Solution Building Block on your own instead of purchasing a building block.
All of these decisions are documented for later reference and show the reasoning behind your decision.
You're Done!
Congratulations!
Documenting your architectural decisions is a recurring task, and it is likely that you will add decisions at later stages of your architecture development. An example is when you think about the deployment of your architecture in the context of the Environments & Location Diagram.
As a natural next step, we recommend to work next on the Conceptual Data Diagram.