diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 231570e6..0bd9fbd8 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -175,9 +175,6 @@ Field Name | Type | Description
channels | [Channels Object](#channelsObject) | The channels used by this [application](#definitionsApplication).
operations | [Operations Object](#operationsObject) | The operations this [application](#definitionsApplication) MUST implement.
components | [Components Object](#componentsObject) | An element to hold various reusable objects for the specification. Everything that is defined inside this object represents a resource that MAY or MAY NOT be used in the rest of the document and MAY or MAY NOT be used by the implemented [Application](#definitionsApplication).
-tags | [Tags Object](#tagsObject) | A list of tags used by the specification with additional metadata. Each tag name in the list MUST be unique.
-externalDocs | [External Documentation Object](#externalDocumentationObject) \| [Reference Object](#referenceObject) | Additional external documentation.
-
This object MAY be extended with [Specification Extensions](#specificationExtensions).
@@ -234,6 +231,8 @@ Field Name | Type | Description
termsOfService | `string` | A URL to the Terms of Service for the API. This MUST be in the form of an absolute URL.
contact | [Contact Object](#contactObject) | The contact information for the exposed API.
license | [License Object](#licenseObject) | The license information for the exposed API.
+tags | [Tags Object](#tagsObject) | A list of tags for application API documentation control. Tags can be used for logical grouping of applications.
+externalDocs | [External Documentation Object](#externalDocumentationObject) \| [Reference Object](#referenceObject) | Additional external documentation of the exposed API.
This object MAY be extended with [Specification Extensions](#specificationExtensions).
@@ -242,7 +241,8 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
```json
{
"title": "AsyncAPI Sample App",
- "description": "This is a sample server.",
+ "version": "1.0.1",
+ "description": "This is a sample app.",
"termsOfService": "https://asyncapi.org/terms/",
"contact": {
"name": "API Support",
@@ -253,13 +253,22 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0.html"
},
- "version": "1.0.1"
+ "externalDocs": {
+ "description": "Find more info here",
+ "url": "https://www.asyncapi.org"
+ },
+ "tags": [
+ {
+ "name": "e-commerce"
+ }
+ ]
}
```
```yaml
title: AsyncAPI Sample App
-description: This is a sample server.
+version: 1.0.1
+description: This is a sample app.
termsOfService: https://asyncapi.org/terms/
contact:
name: API Support
@@ -268,7 +277,11 @@ contact:
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
-version: 1.0.1
+externalDocs:
+ description: Find more info here
+ url: https://www.asyncapi.org
+tags:
+ - name: e-commerce
```
#### Contact Object