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.
- 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/adrdirectory, as exemplified in Nat Pryce's adr-tools. This does not imply we will be using
See Michael Nygard's article, linked above.