-
Docs Are Dead, Long Live Decisions
TL;DR: Code shows what a system does, not why. Your coding harness can explain the how on demand, so stop hand-writing docs for the status quo. Document your decisions instead: use General Decision Records (inspired by Architecture Decision Records) …