Writing about writing
Essays on documentation drift, AI-assisted authoring, and keeping product docs in sync with the code behind them.
- Jun 14, 2026 · 13 min read · GitBook • docs migration • documentation drift
The GitBook migration trap
The obvious way to migrate off GitBook — export every page and import it verbatim — quietly forklifts the drift you were trying to escape, and leaves frozen islands in an otherwise self-updating site. A better migration treats the old docs as a seed, regenerates from the code, and measures topic coverage so you can prove nothing important was lost.
- Jun 13, 2026 · 14 min read · AI support • ticket deflection • documentation quality
How AI can leverage documentation to provide excellent L1 and L2 customer support
Most AI support deployments underperform not because the model is inadequate, but because the documentation it draws on is. How documentation quality directly determines AI support quality across L1 and L2 — and the architecture that keeps an AI knowledge base accurate by syncing it to your codebase.
- Jun 8, 2026 · 12 min read · GitHub • automation • code as source of truth
Why documentation falls behind code (and how to fix it)
The drift between code and docs is a structural problem, not a discipline problem. Three patterns that close the gap by treating documentation the way teams already treat tests, lints, and CI — enforced at the pull-request level, not left to memory.