-
Notifications
You must be signed in to change notification settings - Fork 88
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Revert "Added asynchronous API guidelines content" #73
Conversation
@@ -66,35 +66,5 @@ | |||
|
|||
## Asynchronous API Guidelines | |||
|
|||
* [Introduction to guidelines](asynchronous-api-guidelines/01_introduction/a_introduction.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Only "Introduction" aligned with other sections
* [Introduction to guidelines](asynchronous-api-guidelines/01_introduction/a_introduction.md) | ||
* Basic Concepts | ||
* [Event Driven Architectures](asynchronous-api-guidelines/01_introduction/b_basic_concepts_edas.md) | ||
* [Basic terminology](asynchronous-api-guidelines/01_introduction/c_basic_concepts_terminology.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Basic Terminology
* [Event Driven Architectures](asynchronous-api-guidelines/01_introduction/b_basic_concepts_edas.md) | ||
* [Basic terminology](asynchronous-api-guidelines/01_introduction/c_basic_concepts_terminology.md) | ||
* [Events](asynchronous-api-guidelines/01_introduction/d_basic_concepts_events.md) | ||
* Asynchronous API Guidelines |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Core Principles
* [Basic terminology](asynchronous-api-guidelines/01_introduction/c_basic_concepts_terminology.md) | ||
* [Events](asynchronous-api-guidelines/01_introduction/d_basic_concepts_events.md) | ||
* Asynchronous API Guidelines | ||
* [Contract](asynchronous-api-guidelines/02_asynchronous_api_guidelines/a_contract.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could delete this section, duplicated in General Guidelines
* [Events](asynchronous-api-guidelines/01_introduction/d_basic_concepts_events.md) | ||
* Asynchronous API Guidelines | ||
* [Contract](asynchronous-api-guidelines/02_asynchronous_api_guidelines/a_contract.md) | ||
* [API First](asynchronous-api-guidelines/02_asynchronous_api_guidelines/b_api_first.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could delete this section, duplicated in General Guidelines
* Asynchronous API Guidelines | ||
* [Contract](asynchronous-api-guidelines/02_asynchronous_api_guidelines/a_contract.md) | ||
* [API First](asynchronous-api-guidelines/02_asynchronous_api_guidelines/b_api_first.md) | ||
* [Immutability](asynchronous-api-guidelines/02_asynchronous_api_guidelines/c_immutability.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could move this section to General Guidelines
* [Contract](asynchronous-api-guidelines/02_asynchronous_api_guidelines/a_contract.md) | ||
* [API First](asynchronous-api-guidelines/02_asynchronous_api_guidelines/b_api_first.md) | ||
* [Immutability](asynchronous-api-guidelines/02_asynchronous_api_guidelines/c_immutability.md) | ||
* [Common Data Types](asynchronous-api-guidelines/02_asynchronous_api_guidelines/d_data_types.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We could move this section to General Guidelines
* [API First](asynchronous-api-guidelines/02_asynchronous_api_guidelines/b_api_first.md) | ||
* [Immutability](asynchronous-api-guidelines/02_asynchronous_api_guidelines/c_immutability.md) | ||
* [Common Data Types](asynchronous-api-guidelines/02_asynchronous_api_guidelines/d_data_types.md) | ||
* [Automatic Schema Registration](asynchronous-api-guidelines/02_asynchronous_api_guidelines/e_schema_registration.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe this section should move to Kafka guidelines
This revert, can be closed. |
Changes merged in #71 |
Reverts #71
Re-arrange structure to avoid redundances of section naming in headers' levels
Re-distribute sections meaning to general topics (e.g. Immutability) to General Guidelines.
Remove section redundant with already existing ones in General (e.g. API First).
Move sections 100% related to Kafka to Kafka guidelines section.
Avoid contractions.
Add uppercase in headers.