Diagrams in ADRs and Remixing

#113 - Architecture Decision Record (ADR) - Michael Keeling

Topic 13 of 18

Published Nov 14, 2022 · Clip 29:28–31:04 (1:36)

Michael affirms diagrams belong in ADRs since ADRs are about effective communication. Teams use lightweight visuals: whiteboard photos, Miro screenshots, and Mermaid rendered diagrams in markdown on GitHub. He notes the decision log itself is a change-over-time view of the architecture, and describes 'remixing' — creating new documents like a security or availability view that link to the most relevant ADRs.