Architecture Decision Records (ADR) - The Basics

This video describes the basic idea and implementation or Architecture Decision Records, or "ADRs".  It describes the idea behind them to document design decisions with their context and alternatives considered. 

Interested in what you might encounter when using ADRs in your organization? Check our next video: https://video.saxion.nl/media/1_k2u6kljl

Some additional resources:

• The hydrocoptic marzelvane, turboencabulator, sidefumbling and waneshaft are all inspired from The Turbo Encabulator (Youtube)
• The original article by Michael Nygard (which itself is an ADR!) can be found here: https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions. Although documenting decision is not a new practice, the template of Mr. Nygard has been very succesful in making this practice widespread.
• Some parts of the introduction (among which the pixelating image) were inspired by Michael Keelings talk at Saturn '17. If you found this video informative, youi'll also like (at least) the first 10 minutes of his talk (YouTube).
• For ADR templates and tooling, take a look at http://adr.github.io/
• More info on passive / active voice can be found in the Technical Writing course from Google.