Documentation Center · Meta

How the center works

A generated, never-stale projection of the repository — and the gates that keep it honest.

3034pages

On this page

What this is#

The Oshun Documentation Center is a generated projection of the repository (see docs/proposals/DOCS_CENTER_PROPOSAL.md). Mechanical structure — the enumeration of products, pages, journeys, and entity nodes, plus the cross-links and this coverage report — is generated so it can never drift from the code; the understanding on top of it is authored prose.

How it stays never-stale#

Every page renders deterministically from its Markdown (or the project graph), and the rendered HTML is never committed (audit R-2, 2026-07-16): CI rebuilds the whole center from source on every relevant change and publishes it as a build artifact, so a served page cannot drift from the sources it was rendered from. A verification gate (pnpm docs:center:verify) additionally proves there are zero broken internal links and zero dead source paths in the rendered output. For a local render, a regenerate-and-diff freshness check (pnpm docs:center:check) fails if the on-disk HTML drifts from source.

Building & checking#

bash
pnpm docs:center          # build the whole center locally
pnpm docs:center:check    # freshness: on-disk render == source
pnpm docs:center:verify   # integrity gate (CI): links + source paths

See the coverage & health report for the live snapshot and the integrity gate status.