Blogs

A navy blueprint and a teal machine part side by side, joined by measuring lines, with one coral marker where the shapes don't match

Bishwanath Parajuli
Sep 25,2026
Technology

API contract testing for docs: proving your OpenAPI spec matches the API

Agents and SDK generators build from your OpenAPI spec, not your prose. Learn how API contract testing with Schemathesis catches spec drift before it ships.

Teal stepping stones cross a navy ravine with small flags marking each stone, and one gap in the path is bridged by a coral plank

Bishwanath Parajuli
Sep 20,2026
Business

Writing procedures AI agents can follow: prerequisites, defaults and expected results

AI agents fill gaps in how-to docs with guesses. Learn the four things every procedure must state: access, versions, defaults and expected results.

An open document whose numbered steps are wired to a navy control panel, teal ticks on passing steps and one coral warning on a broken step

Bishwanath Parajuli
Sep 18,2026
Technology

Docs as tests: running your documented procedures against the real product

Docs as tests runs your documented procedures against the real product in CI. See how Doc Detective works and how to catch drift before users or agents do.