hamid/baya-monorepo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc clean up phase 2

Browse Source
This commit is contained in:
hamid
2026-07-30 12:49:46 +03:30
parent c889c46110
commit c841bded26
36 changed files with 2970 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files
dev/contracts/openapi/README.md
+13 -1
View File
@@ -1,4 +1,16 @@
# OpenAPI snapshots
# OpenAPI snapshots — MOVED to `docs/integration/openapi/`
> ⛔ **The `swagger.v1.json` in this folder is the 2026-07-13 snapshot and is stale.** The current one is
> [`docs/integration/openapi/`](../../../docs/integration/openapi/README.md) (2026-07-29, 178 paths / 186
> operations), with its provenance and regeneration steps recorded there.
>
> The claim below that the server "publishes documents `v1`, `v1.1`" is literally true and substantively
> empty: both documents are registered, but all 55 controllers are `[ApiVersion("1")]`, so the `v1.1`
> document contains **zero paths** (contradiction **C-9**, resolved in phase 2).
>
> Phase 6 archives this folder. Until then, read it as a record.
---
The server already generates OpenAPI via **NSwag** (Swagger UI at `/swagger`, documents `v1`, `v1.1`).
This folder holds the **published `swagger.json` snapshot(s)** so the frontend can generate/verify types