Deleted planning document still cited 73 times across codebase, now pointing at nothing
A developer grepping a repository found that PLAN.md, a planning document deleted on 2 September, is still referenced 73 times across 43 files. The citations cover twelve section numbers and are concentrated in the rules engine, where they justify privacy and regulatory decisions. The deletion came in a commit that changed 161 files and was not mentioned in its message, and nothing else in that commit updated the references. The author argues that dead citations are worse than none, because they signal stale documentation and erode trust in the rest of it. The file still exists in git history and can be recovered with a single command.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.


Discussion (0)
Log in to join the discussion and vote.
Log in