You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Swagger docs are generated manually via make swagger and committed. If a developer changes handler annotations but forgets to regenerate, CI passes but the committed docs are stale.
Acceptance criteria
Add a CI step in backend-ci.yml that runs make swagger and then checks for a clean git diff
If the diff is non-empty, fail the job with a message directing the developer to run make swagger locally
Document this requirement in backend/docs/swagger.md
Problem
Swagger docs are generated manually via
make swaggerand committed. If a developer changes handler annotations but forgets to regenerate, CI passes but the committed docs are stale.Acceptance criteria
backend-ci.ymlthat runsmake swaggerand then checks for a clean git diffmake swaggerlocallybackend/docs/swagger.md