← WORKS

Documenting Software Architectures: Views and Beyond

Kruchten, Bachmann & Bass (2011) — architecture documentation including decisions

Work

Second-edition practitioner guide to documenting software architecture — views, stakeholders, and decision rationale as durable record.

Paul Clements, Felix Bachmann, Len Bass, David Garlan, James Ivers, Reed Little, Paulo Merson, Robert Nord, and Philippe Kruchten (2011). Documenting Software Architectures: Views and Beyond (2nd ed.). Addison-Wesley.

(First edition 2003; Nygard’s 2011 ADR post references Kruchten on decision importance and points readers to this line of work.)

What we cite

  • Decision-focused documentation as part of professional architecture practice — decision logs / registers before the “ADR” label converged on Nygard’s in-repo markdown format.
  • Distinction — this book is comprehensive architecture documentation; Nygard (2011) is the lightweight, version-controlled, one-decision-per-file pattern the corpus treats as industry ADR.

Philippe Kruchten