From 29d867fbfb9f89c26fc3a1e690a139eec742ea2e Mon Sep 17 00:00:00 2001 From: apidesigner Date: Sat, 23 Jun 2018 13:03:08 +0000 Subject: [PATCH] Updates SUMMARY.md Auto commit by GitBook Editor --- README.md | 2 ++ SUMMARY.md | 2 +- rest/core-principles/introduction.md | 45 ---------------------------- rest/introduction.md | 45 ++++++++++++++++++++++++++++ 4 files changed, 48 insertions(+), 46 deletions(-) create mode 100644 rest/introduction.md diff --git a/README.md b/README.md index 91d8037..e49370c 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,8 @@ The API Guidelines are split into two main parts: * General Guidelines * API type-specific Guidelines + * [REST APIs Guidelines](/rest/introduction.md) + * [Kafka Guidelines](/kafka/introduction.md) The general guidelines section discusses the core principles relevant to any kind of API. The API type-specific section further defines the guidelines specific to a given architectural style or API technique \(such as REST, Kafka or GraphQL API\). diff --git a/SUMMARY.md b/SUMMARY.md index b2901fb..15af596 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -17,7 +17,7 @@ ## REST API Guidelines -* [Introduction](rest/core-principles/introduction.md) +* [Introduction](rest/introduction.md) * [Core Principles](rest/core-principles/README.md) * [OpenAPI Specification](rest/core-principles/openapi-specification.md) * [API Design Platform](rest/core-principles/apiary.md) diff --git a/rest/core-principles/introduction.md b/rest/core-principles/introduction.md index deea0b3..e69de29 100644 --- a/rest/core-principles/introduction.md +++ b/rest/core-principles/introduction.md @@ -1,45 +0,0 @@ -# adidas REST API Guidelines - -The adidas REST API Guidelines defines standards and guidelines for building REST APIs at adidas. These Guidelines has to be followed in addition to the General Guidelines. - -The REST API Guidelines are further split into the following parts: - -* **Core Principles** - - REST API Guidelines Core Principles defines the rules that **MUST** be followed at throughout the full API lifecycle. - -* **Functionality Guidelines** - - * [**Protocol level**](https://adidas-group.gitbooks.io/api-guidelines/content/protocol/) - - Protocol guidelines define the protocols used within the organization. - - * [**Message level**](https://adidas-group.gitbooks.io/api-guidelines/content/message/) - - The Message guidelines define the structure and semantics of messages used to exchange information. - - * [**Application level**](https://adidas-group.gitbooks.io/api-guidelines/content/application/) - - The Application guidelines define the definition and use of application-specific semantics. - -* **Quality Guidelines** - - Evolution and Execution guidelines define the rules for achieving the desired architectural qualities of systems. - - * [**Evolution**](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/) - - Evolution qualities governance, such as testability, maintainability, extensibility, and scalability. - - * [**Execution**](https://adidas-group.gitbooks.io/api-guidelines/content/execution/) - - Execution qualities governance, such as security and usability. - -* **Guides** - Guides and materials supporting the REST API Guidelines - -* **API Clients** - - Section dedicated to consumers of adidas APIs - - - diff --git a/rest/introduction.md b/rest/introduction.md new file mode 100644 index 0000000..deea0b3 --- /dev/null +++ b/rest/introduction.md @@ -0,0 +1,45 @@ +# adidas REST API Guidelines + +The adidas REST API Guidelines defines standards and guidelines for building REST APIs at adidas. These Guidelines has to be followed in addition to the General Guidelines. + +The REST API Guidelines are further split into the following parts: + +* **Core Principles** + + REST API Guidelines Core Principles defines the rules that **MUST** be followed at throughout the full API lifecycle. + +* **Functionality Guidelines** + + * [**Protocol level**](https://adidas-group.gitbooks.io/api-guidelines/content/protocol/) + + Protocol guidelines define the protocols used within the organization. + + * [**Message level**](https://adidas-group.gitbooks.io/api-guidelines/content/message/) + + The Message guidelines define the structure and semantics of messages used to exchange information. + + * [**Application level**](https://adidas-group.gitbooks.io/api-guidelines/content/application/) + + The Application guidelines define the definition and use of application-specific semantics. + +* **Quality Guidelines** + + Evolution and Execution guidelines define the rules for achieving the desired architectural qualities of systems. + + * [**Evolution**](https://adidas-group.gitbooks.io/api-guidelines/content/evolution/) + + Evolution qualities governance, such as testability, maintainability, extensibility, and scalability. + + * [**Execution**](https://adidas-group.gitbooks.io/api-guidelines/content/execution/) + + Execution qualities governance, such as security and usability. + +* **Guides** + Guides and materials supporting the REST API Guidelines + +* **API Clients** + + Section dedicated to consumers of adidas APIs + + +