I’ve been trying to push myself and my team members to document the outcome of decisions we make and the analysis/research performed to reach said decision. We are often asked questions like “Did you think about doing … instead of …?” or “Did you account for …?”. Most of the time, they are valid questions, and more often than not the concern was evaluated but we have no way to prove it or to ensure that we indeed account for what we are being asked for.

I spent a lot of time trying to come out with a comprehensive template to codify architectural decision and had to scrap a lot of ideas, then I found a fantastic resource publicly available! So I thought this would be a fantastic resource for other architects that may be looking/struggling to do this.

Architecture Decision Record by joelparkerhenderson

I hope it is as useful to you as it was for me!