Skip to main content

Diana Payton

Documentation systems that hold up — for humans and agents.

What is this site?

This site is a working documentation pipeline. It's not a static collection of samples — every change goes through automated quality checks before it ships.

It demonstrates what a production-ready documentation system looks like: one that catches problems early, scales with a growing team, and produces content that works for both human readers and AI agents.

The workflow

Each pull request runs four automated checks:

  • Style — Vale enforces writing standards using custom rules
  • Spelling — codespell scans all source files for errors
  • Links — Lychee flags broken links before they reach production
  • Accuracy — Doc Detective tests that documented steps still match the product

The pipeline also includes Claude Code skills — agentic workflows that automate repetitive tasks like starting the dev server, running checks, and scaffolding new posts.

The site also includes an API reference sample built with OpenAPI 3.1 and a llms.txt file that structures content for AI agents.

See how the pipeline works →