Articles

Notes on documentation that keeps up.

Writing about why documentation goes out of date, what makes a page checkable rather than merely written, and what changes when most of the code is produced by an agent.

Your 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.

Read

Documentation 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.

Read

New posts are infrequent and only when there's something worth saying. Subscribe by RSS, or follow the repo.