Nepomuk

Sign in Subscribe

ADR

Architecture Decision Records

TIL: Documenting Architecture Decisions with ADRs

Today I re-read the article by Michael Nygard, Documenting Architecture Decisions and wanted to mention it in my TILs. * An ADR is like a conversation with a future developer on the project. * “A new person coming on to a project may be perplexed, baffled, delighted, or infuriated by some past

ADR: 1. Record architecture decisions

Status Accepted Context We need to record the architectural decisions made on this project. Decision We will use Architecture Decision Records, as described by Michael Nygard. Consequences See Michael Nygard’s article, linked above. For a lightweight ADR toolset, see Nat Pryce’s adr-tools.