https://emsenn.net/tags/documentationpractice/ Recent content in DocumentationPractice on emsenn.net Hugo en-us Sat, 07 Mar 2026 00:00:00 +0000 https://emsenn.net/library/domains/engineering/domains/tech/domains/computing/domains/software-engineering/domains/structured-work-paradigms/texts/architecture-decision-records/ Sat, 07 Mar 2026 00:00:00 +0000 https://emsenn.net/library/domains/engineering/domains/tech/domains/computing/domains/software-engineering/domains/structured-work-paradigms/texts/architecture-decision-records/ <p>Architecture Decision Records (ADRs) are short text documents that capture a single architectural decision, its context, and its consequences. Michael Nygard introduced the format in a November 2011 blog post titled &ldquo;Documenting Architecture Decisions,&rdquo; published on the Cognitect blog (Nygard, 2011). The post argued that agile projects need lightweight documentation that stays close to the code, rather than large design documents that fall out of date.</p> <h2 id="format">Format</h2> <p>Nygard&rsquo;s original ADR format draws on the structure of Alexandrian patterns. Each record contains five sections:</p>