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

A practical documentation freshness checklist

Review accuracy with evidence, not just the date at the top of a page.

Read article

API documentation best practices beyond reference

Help a developer make the first request, understand the model, and recover from failure.

Read article

Documentation migration redirects without losing SEO

Preserve intent, test every route, and monitor what happens after the DNS change.

Read article

Docs 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

llms.txt, MCP, and documentation for agents

The formats solve different discovery, retrieval, and tool-access problems.

Read article

Why documentation goes stale

Drift is a systems problem, not a motivation problem.

Read article

Documentation for humans and agents

One reviewed source can serve browsers, search, retrieval, and tools.

Read article

A practical GitBook migration checklist

Move the content, preserve the addresses, and verify what readers actually receive.

Read article