ADRXXX ====== :Number: XXX :Title: Short nouns summarizing the decision. :Author: Max Mustermann :Created: 2021-06-20 :Status: Proposed / Approved / Postulated / Superseded .. contents:: Table of Contents Context ------- Benefit / Purpose of the decision, and what the technical context was that lead to it. Should be written in a way that can be understood by any team member three years later. Decision -------- Things of the following kind: - Instead of doing X like we always did, we're now going to do Y. - We're starting to do X. - We're not doing Y anymore because reason X which lead to Y is obsolete. Consequences ------------ Immediate changes are X, to consolidate all things to Y requires such and such effort. Long term effects are Z. In the dailly work of a developer working on C, instead of just doing D, D' has to be done as well.