docs/api.md is 1 838 lines and 16 000 words, about 30 lines per endpoint. Field lists, types and JSON examples duplicate the served OpenAPI spec (/docs) and the generated api-types.ts. Rule per endpoint: one sentence of semantics, the business error codes, the rate limit, and a link to the generated schema for the fields; delete the field lists and examples the spec already carries. Expected size about a third. One pass, sections in the order of Endpoints at a glance. Maintainer decision 2026-08-18.
Imported from planning/backlog.md.
docs/api.mdis 1 838 lines and 16 000 words, about 30 lines per endpoint. Field lists, types and JSON examples duplicate the served OpenAPI spec (/docs) and the generatedapi-types.ts. Rule per endpoint: one sentence of semantics, the business error codes, the rate limit, and a link to the generated schema for the fields; delete the field lists and examples the spec already carries. Expected size about a third. One pass, sections in the order of Endpoints at a glance. Maintainer decision 2026-08-18.Imported from planning/backlog.md.