Notes on documentation that keeps up.
Longer pieces on documentation drift: why pages go out of date, what makes one checkable rather than merely written, and what changes when most of the code is produced by an agent. Written while building Wiki Pilot, and honest about the parts it doesn't solve.
What actually belongs in a codebase wiki
Ten sections and the argument for each. Most internal wikis fail at the structure step, long before anyone runs out of willingness to write.
ReadYour docs aren't wrong. They're unverifiable.
Documentation doesn't rot because people are lazy. It rots because nobody can check it. Two fields in the frontmatter change that.
ReadDocumentation drift in the age of coding agents
Drift isn't new. The rate is. And now the docs feed back into the tools writing your code, which is a failure mode we didn't have before.
ReadNew posts are infrequent and only when there's something worth saying. Subscribe by RSS, or follow the repo.