Statusโ
Accepted
Contextโ
We are in search for a means to describe our technical architecture.
We are a small team working in a very lean and agile way (XP), so we naturally prefer also light-weight documentation methods which also accomodate change easily.
Decisionโ
- We will use Architecture Decision Records, as described by Michael Nygard in this article.
- We will follow the convention of storing those ADRs as Markdown formatted
documents stored under
docs/adr
directory, as exemplified in Nat Pryce's adr-tools. This does not imply we will be usingadr-tools
itself.
Consequencesโ
See Michael Nygard's article, linked above.