Architecture decision records

• Michael Nygards blog article
• Overview with helpful tools and templates
• Github repository with templates

adr parts

• title
• decision
• status
• context
• consequences
• alternatives

docs as code

• Save adr in git (e.g. as markdown) and get consent of the team with reviewed pullrequests.
• Enumerate the adrs to get a log of decisions e.g. adr-XXXX-searchable-title.mds
• Use something like github pages to publish your ads.