The reference section is generated from the consumer API worker-owned OpenAPI document.
- Public API worker export:
workers/consumer-api/src/docs/openapi.ts - Site generation script:
apps/docs/scripts/generate-api-docs.ts
Each build writes:
- Markdown reference page under
src/content/docs/reference/consumer-api.md - Raw JSON spec under
public/openapi/consumer-api.json
This keeps the documentation site as a consumer of API definitions instead of the place where endpoint details are maintained manually.