mirror of
https://github.com/adidas/api-guidelines.git
synced 2025-10-25 15:19:19 +00:00
Creates rest/core-principles/quality.md
Auto commit by GitBook Editor
This commit is contained in:
16
rest/core-principles/apiary.md
Normal file
16
rest/core-principles/apiary.md
Normal file
@@ -0,0 +1,16 @@
|
||||
# API Design Platform - Apiary
|
||||
|
||||
1. [Apiary](https://apiary.io/) is the primary platform supporting [API first approach](./api-first.md). Apiary **MUST** be used during API Design.
|
||||
|
||||
2. Every API description **MUST** be stored in [Apiary](https://apiary.io/) under the ADIDAS GROUP team.
|
||||
|
||||
3. Apiary **MUST** be the **single source of truth** to learn about existing APIs within the organization.
|
||||
|
||||
> NOTE: Apiary supports API-first approach in multiple ways:
|
||||
> a. 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\)
|
||||
>
|
||||
> NOTE: The synchronization between the version control system and adidas [API Description platform](./apiary.md)
|
||||
> should be automated using CI/CD framework.
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user