Development log

What was decided, when, and why — including the reversals. Written as the work happens, which is why it contains things a retrospective account would have tidied away.

The development log records decisions rather than commits. Not what changed — the version control history already says that — but why it changed that way, and what the alternative cost.

It is written during the work, not reconstructed afterwards. That is what makes it worth reading and what makes it occasionally awkward: the reversals are here too, with the measurement that forced them.

The log is one continuous file in the repository, published here one year at a time. Entries are in reverse chronological order, every one of them dated, and every date checkable against the repository history.

Source: docs/JOURNAL.md in the public repository — this page is a copy of it, not a summary.