Documentation
how-to/write-adrs.md
title: Writing Architectural Decision Records
author:
- Daniel Castonguay
version: 1.1.0
About
When making significant decisions it is extremely important to document them as an ADR.
This repository is large and complex and it can become very easy to forget why we did something or the reason we didn't go with some particular alternative.
This document provides information that will help you author quality architectural decision records.
Feel free to use any existing ADRs for inspiration.
There is also a base ADR template available for reference.
Rules and Guidelines
- Save ADRs to
/docs/adrs/XXX-title.md