Context, Constraints, Choices, Results

A project's decision record is the set of decisions that shaped it, each with its situation, its limits, the options considered, and its result. Few projects keep such a record in one place. The pieces are spread across design documents, tickets, chat threads and dashboards, and in the memories of the people involved.

Explaining a project well depends on rebuilding that record first. The record is then presented in four parts: context, constraints, choices, and results. The Senior engineer from the previous lesson chose the search indexing rebuild as their main project