Why
So a swagger spec can be generated & consumed by swagger UI & swagger clients.
This may help with testing/verifying and SDK integrations with the server e.g. seeing the expected format of request & response bodies.

Suggestions

• https://github.com/go-swagger/go-swagger
• Add annotations to the server endpoints (annotations conform to what go-swagger expects)
• Use go-swagger to generate the swagger spec from annotations
• Try get this working with the Swagger UI https://github.com/swagger-api/swagger-ui and/or a swagger client
• Investigate if this would help with testing/verifying changes in PRs (as part of some CI check) or for regression testing