gen-api-reference

Overview ¶

Command gen-api-reference regenerates the route tables in docs/api-reference.md and the route metadata in internal/api/openapi_gen.go, both derived from the mux registrations in internal/api/routes*.go.

Usage (from the repo root): go run ./scripts/gen-api-reference Pass -check to exit non-zero instead of writing when any output is stale. It also writes docs/public/openapi.json, an OpenAPI 3.1 document.