“A general rule is to follow an “inverted pyramid” style of writing, commonly associated with news stories. The key is to put the most important material at the start, and push details to later in the record.”
NEW POST ADRs are short documents that capture a decision, structured into logs that reveal a history of architectural thinking for a product https://martinfowler.com/bliki/ArchitectureDecisionRecord.html
“ADRs contain not just the decision, but also a brief rationale for the decision. This should summarize the problem that led to this decision being needed and the trade-offs that were taken into account. A good way to think of them follows the notion of “forces” when writing a pattern.”
https://martinfowler.com/bliki/ArchitectureDecisionRecord.html
“ADRs are short documents that capture a decision, structured into logs that reveal a history of architectural thinking for a product”
— Martin Fowler
Ruth — of systems & design
