apidocs

Overview ¶

Command apidocs writes the REST API reference (docs/reference/api.md) from the OpenAPI document, so the page cannot drift from the API:

go run ./scripts/apidocs -in api/openapi.yaml -out docs/reference/api.md

Operations are grouped by their first tag, in the order the document lists its tags, then by path in document order. Every schema in components is listed after the operations.