Record why an approach was rejected—and when to revisit it

Disclosure: I maintain Selvedge, an open-source decision-history tool. This article was prepared with AI assistance from Grok and Codex. The example below is hypothetical and uses plain Markdown; it does not require a particular product. A repository can show what the code does while leaving out why an apparently reasonable alternative was...