Blog

Notes on treating documentation as a versioned contract

Why specs need versions, how coding agents should read the docs you actually ship, and what a dependency graph is worth once CI maintains it instead of a person.

RSS feed
5 min read

Reconciling a dependency graph from CI instead of a laptop

A dependency graph maintained by hand is a graph that is wrong. Reconcile it from a merge to the default branch, record the blob sha, and let a breaking change fail the build.

cidependency graphopenapiautomation
4 min read

Why your docs should be versioned like your code

A wiki page has one state: current. An API contract has as many states as there are things built against it. Versioned documentation is what closes that gap.

versioningsemveropenapiengineering