u

README.md

@@ -23,6 +23,14 @@ Default port: `4208`.
 
 See [docs/api](docs/api/README.md) for endpoints, auth flow, and frontend integration.
 
+Docs are generated from `@openapi` JSDoc on route handlers:
+
+```bash
+npm run docs:api
+```
+
+That writes `docs/api/openapi.json` and per-route Markdown under `docs/api/routes/`.
+
 ## Users
 
 Manage the email allowlist: