- SwaggerHub is the primary platform supporting API first approach. SwaggerHub MUST be used during API Design.
- Every API description MUST be stored in SwaggerHub under the adidas team.
- SwaggerHub MUST be the single source of truth to learn about existing APIs within the organization.
NOTE: SwaggerHub supports API-first approach in multiple ways:
For example, it validates API description for correctness and automatically generates API documentation to drive the discussion between stakeholders. (No more emails with API description flying between stakeholders)