Decisions¶

Dated records of design choices: what was decided, what was tried first, and why. They explain the code as it is and stop settled questions from being reopened by accident. Read the record for an area before changing it, and before rebuilding anything a record says was retired.

A record describes the moment it was written. When a later decision replaces it, the old record stays and gains a link to the new one. How to write one is in Writing documentation.