Doctorine guides
Build API delivery systems that stay true to the contract.
These field guides turn standards and product boundaries into workflows a platform, DevEx, API product, or documentation team can test. Each guide answers the question early, shows the work, names failure modes, and records its review date.
Maintained library
Start with the decision blocking your release
The collection is intentionally small. A page enters this library only when it has a distinct search intent, an accountable owner, an explicit technical review scope, primary-source support, a useful artifact or checklist, and descriptive links back to the product surface where the method applies.
-
API lifecycle management
API Delivery vs API Management: Where Each Fits in the API Lifecycle
API management governs runtime traffic and policy. API delivery turns a contract into docs, SDKs, examples, and agent tools. Learn where each belongs.
Accountable owner: Aria Shishegaran. Tested ; refresh due .
Read api delivery vs api management: where each fits in the api lifecycle -
Docs as code guide
Docs as Code: A Workflow That Prevents API Drift
Use this docs-as-code workflow to review prose, OpenAPI, examples, generated reference, and release evidence together without creating a second source of truth.
Accountable owner: Aria Shishegaran. Tested ; refresh due .
Read docs as code: a workflow that prevents api drift -
OpenAPI to MCP guide
OpenAPI to MCP: Build Safe, Useful Agent Tools
A practical OpenAPI-to-MCP workflow for operation selection, tool schemas, descriptions, authorization, side effects, testing, and release verification.
Accountable owner: Aria Shishegaran. Tested ; refresh due .
Read openapi to mcp: build safe, useful agent tools -
API documentation examples
API Documentation Examples: A Practical Evaluation
Evaluate API documentation examples with a first-call rubric covering orientation, authentication, requests, responses, errors, operations, and change safety.
Accountable owner: Aria Shishegaran. Tested ; refresh due .
Read api documentation examples: a practical evaluation
Editorial contract
Evidence before volume
We do not publish a keyword page merely because demand exists. Product claims must match shipped behavior, standards claims link to primary sources, and examples must lead to an action a reader can reproduce. Unsupported or roadmap capabilities are labeled at the point where they matter.
Browse the broader resource directory for product routes and future tools, or start with the API delivery platform overview when the buying decision is already clear.
Apply the guidance to a real contract.
Import one OpenAPI description and inspect the portal, SDK, and agent-readable context produced from the same canonical graph.
Import an OpenAPI spec