tl;dr:“We want to document decisions, and we know when, but what do we actually write? Here, too, I like to keep it lightweight. A decision record should contain, at a minimum: (1) Some context or problem. (2) A decision made in response to it. Assume your audience is proficient, but lacking context – that’s why they’re reading!”