# Architecture Decision Records Decisions that are hard to reverse, surprising without context and the result of a real trade-off. Each record states the context, the decision and why it was made. ```{toctree} :maxdepth: 1 :glob: 0* ```