nimblehq / gin-templates

Our optimized Gin templates used in our projects

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Add OpenAPI to support creating API documentation with OpenAPI

suho opened this issue · comments

commented

Why

The team now has OpenAPI Training Path to learn and practice. OpenAPI on Compass for developers to follow conventions and best practices. NO OpenAPI boilerplates currently exist in the gin templates to support web developers in creating API documentation with OpenAPI.

Acceptance Criteria

  • Add OpenAPI addon as an optional addon in the template.
  • Add OpenAPI tooling (Spectral, Elements, Lint).
  • Create an endpoint (e.g., GET {{base_url}}/api/docs/openapi) to access the API documentation through the browser.
  • Add Mock Server with Prims (related to this API Mock Server with OpenAPI).
  • Add CI/CD workflow to run linting and deploy mock server to fly.io.

Resources

Who Benefits?

Everyone

@suho Could you help recheck the OpenAPI Training Path link? I got a 404 page, not sure if it's because I don't have enough permission or the link is broken 🙏🏼

@carryall Thank you. I updated the content with more details.