Some months ago I read Samuel Albanie’s post Documentation Considered (Increasingly) Harmful. In it, Albanie argues that documentation quickly goes “stale” and doesn’t reflect the real state of a codebase, especially when it’s being frequently updated. Stale documentation is a real problem, but in my experience agents are simply not good enough yet at poking […]