Topic

Documentation

3 min read

Docs Search: Hosted Indexing vs Static Build-Time Search

Quick answer: Docs search is a core navigation feature, not an add-on, and the choice between a hosted search index and build-time static search is really a decision about infrastructure,

Read article
3 min read

Bundling Multi-File OpenAPI: $ref Resolution Compared

Quick answer: Splitting an OpenAPI document across files is the right move for large APIs, but every tool that consumes the spec — docs, mock servers, code generators, gateways — needs a

Read article
4 min read

Publish API docs and an MCP endpoint from one spec with a custom domain

Docs, mock, and MCP endpoint usually mean three pipelines, three versions, and three sources of drift. Here is how to publish human docs and an agent endpoint from one OpenAPI document on your own domain, with access control, versioning, and a rollback path.

Read article