[qznc]

Our design decision documents have essentially four sections: Problem description, solution options, comparison of the options, and decision. I find it helpful to clearly distinguish what is part of the problem and what part of the solution. The size of the sections varies a lot.

Meta information could be: Status, stakeholders, decision-makers, and rollout description. It also often has links to meeting protocols and tickets.

[crocal]

These are not architecture documents but change management documents. Roll out of such decisions should, among other things, result in an update to architecture docs.