Technology blogs

Abstract code blocks of teal and navy bars travel along a conveyor through a checking gate, with a coral chain link joining two blocks

Bishwanath Parajuli
Sep 27,2026
Technology

Documentation code samples that work: complete, tagged and tested in CI

Learn what makes documentation code samples complete, why language tags help AI agents, and how to test samples and check their links in CI.

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.

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.