Blog
Documentation is a system.
Notes on keeping product knowledge accurate, discoverable, portable, and useful after launch day.
A documentation review process teams will use
Turn product change into a small, owned queue instead of a quarterly documentation panic.
Read article 2026-08-31 · 6 min readA practical documentation freshness checklist
Review accuracy with evidence, not just the date at the top of a page.
Read article 2026-08-31 · 8 min readAPI documentation best practices beyond reference
Help a developer make the first request, understand the model, and recover from failure.
Read article 2026-08-31 · 7 min readDocumentation migration redirects without losing SEO
Preserve intent, test every route, and monitor what happens after the DNS change.
Read article 2026-08-31 · 6 min readDocs as code and visual editing can work together
Keep Git as the source of truth while making contribution accessible to the whole team.
Read article 2026-08-31 · 7 min readllms.txt, MCP, and documentation for agents
The formats solve different discovery, retrieval, and tool-access problems.
Read article 2026-08-31 · 6 min readWhy documentation goes stale
Drift is a systems problem, not a motivation problem.
Read article 2026-08-28 · 7 min readDocumentation for humans and agents
One reviewed source can serve browsers, search, retrieval, and tools.
Read article 2026-08-24 · 8 min readA practical GitBook migration checklist
Move the content, preserve the addresses, and verify what readers actually receive.
Read article