Writing about writing
Essays on documentation drift, AI-assisted authoring, and keeping product docs in sync with the code behind them.
Alternatives to DeepWiki
Looking for alternatives to DeepWiki? Compare Claude Code, Git2Docs, Mintlify and Docusaurus by who reads the docs, private repo support and upkeep.
How-to: Create docs with Claude Code, step by step
Create docs with Claude Code, step by step: set up CLAUDE.md, generate by module, test examples, publish, and keep docs accurate every release.
Measurable documentation for the agent era
AI agents now read and act on your docs, so accuracy and coverage have to be measured. How to measure docs against shipped code.
Connecting your docs to AI agents: MCP, llms.txt, and Markdown
How to expose your docs to coding agents with MCP, llms.txt and Markdown, and why keeping the content accurate is the hard part.
The hidden cost of documentation debt
Documentation debt never causes an incident, so it never gets prioritized. How to make it visible and budget for it like technical debt.
The GitBook migration trap
Exporting GitBook page by page carries your stale docs with you. A better migration regenerates from code and proves nothing was lost.
How AI can leverage documentation to provide excellent L1 and L2 customer support
AI support is only as good as the docs behind it. How documentation quality drives L1 and L2 answers, and how to keep it accurate.
Why documentation falls behind code (and how to fix it)
Docs drift from code because of structure, not discipline. Three patterns that enforce documentation at the pull request, like tests and CI.