Decisions

One hard-to-reverse call per record, with the reasoning that produced it.

Each file in this folder is numbered, and the number is assigned once and never reused, so a link to a decision stays good and the sequence tells you what came after what. Write the decision, the context it was made in, why this option won over the alternatives, and what it commits you to. The why is the part that stops the same argument being had again in six months, and it is the part nobody remembers without a record.

This folder is an ordinary folder. It has an index.md because every folder page does, and the decisions inside it are its children. Nothing special-cases it.