Index / 6 projects

Work

Each of these started as a pile of documents somebody could no longer maintain. What shipped was a system — a source of truth, a build, and a set of rules that hold without me in the room.

001

API Sculptor

Design & build / 2025

A documentation system that treats an OpenAPI spec as the single source of truth, then sculpts client-specific reference sites out of it without ever forking the master file.

Outcome

One spec, many audiences — no divergent copies to reconcile.

OpenAPI 3.1Redocly CLINodeCI
Read the write-up
002

OpenAPI Architecture Explorer

Architecture & docs / 2025

A navigable map of a large, multi-file OpenAPI surface — paths, schemas, components and their dependencies — so writers can see what a change actually touches before making it.

Outcome

Impact of a schema edit visible in seconds instead of guesswork.

OpenAPIBundlingStatic analysis
Read the write-up
003

Redocly decorators pipeline

Tooling / 2025

Non-destructive decorators that generate customised OpenAPI views per client at bundle time, leaving the master specification untouched.

Outcome

Client-specific docs with zero manual spec surgery.

RedoclyDecoratorsYAML
Read the write-up
004

Vale in the writing loop

Process design / 2025

Style and terminology enforcement wired directly into the editor through VS Code tasks, so the linter runs against the file you are writing rather than in a separate tool.

Outcome

Style feedback at authoring time, not review time.

Vale CLIVS Code tasksPython
Read the write-up
005

Docs-as-code pipeline

Pipeline design / 2025

A full CI pipeline for product documentation — linting, link checking, build and deploy — giving docs the same release discipline as the code they describe.

Outcome

Broken links and style drift caught before merge.

GitCIMarkdownAsciiDoc
Read the write-up
006

Stripe-grade API reference

Build / 2025

A three-column, example-forward API reference built on open-source Docusaurus and Redoc — the Stripe reading experience without the Stripe budget.

Outcome

Reference docs developers actually finish reading.

DocusaurusRedocusaurusRedoc
Read the write-up

Note

Client-confidential work is not listed here. If you need to see something closer to your own stack, ask me directly and I will walk you through what I can share.

Ask me