Project documents
These are the repository's own documents, copied verbatim when the site is built. They are written for a contributor rather than for a consumer, and their relative links point at files in the repository.
- Roadmap — what is done and what is next, gate by gate.
- Hazards — the measured divergences between the pinned Swagger spec and what Codeberg actually returns. Two of the project's original assumptions turned out to be wrong here, which is why the models are built from captured fixtures rather than from the spec.
- Readiness — an honest gap assessment of what stands between this repository and a third party using it.
- API inventory — the endpoint-level checklist.
- Changelog — Keep a Changelog format.
- Architecture decision records — in
adr/, starting with ADR-0005 on why the API isFuture-based and ADR-0001 on why the models are hand-written rather than generated.