From 8733388bde2a0b7ea4570dc324422fd264fd36ec Mon Sep 17 00:00:00 2001
From: Josh Ponelat <josh.ponelat@smartbear.com>
Date: Mon, 22 Aug 2022 12:30:39 +0200
Subject: [PATCH 1/6] Update asyncapi.md

Change note about `$ref` fixed field, to prevent scaring folks off from using `$ref` under `channels`.
---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index df774a4f..1839761f 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -569,7 +569,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Usage of the `$ref` property has been deprecated.
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Technical Note:** Going forward, `$ref` will no longer form part of the ChannelItem Object _fixed fields_, but will continue to function in the same role, as part of [Reference Object(#referenceObject).
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.

From 3dfb71d0db731588e98c0282744748ae39b36b4f Mon Sep 17 00:00:00 2001
From: Josh Ponelat <josh.ponelat@smartbear.com>
Date: Mon, 22 Aug 2022 12:37:06 +0200
Subject: [PATCH 2/6] Update asyncapi.md

---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 1839761f..30af10f4 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -569,7 +569,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Technical Note:** Going forward, `$ref` will no longer form part of the ChannelItem Object _fixed fields_, but will continue to function in the same role, as part of [Reference Object(#referenceObject).
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Technical Note:** Going forward, `$ref` will no longer form part of these _fixed fields_, but will continue to function in the same role, as part of [Reference Object](#referenceObject).
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.

From c8f2cd4849c097212b41a5f290e0d78a1d8e647f Mon Sep 17 00:00:00 2001
From: Josh Ponelat <josh.ponelat@smartbear.com>
Date: Tue, 23 Aug 2022 10:53:12 +0200
Subject: [PATCH 3/6] Update asyncapi.md

---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 30af10f4..6c0b2d9c 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -569,7 +569,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Technical Note:** Going forward, `$ref` will no longer form part of these _fixed fields_, but will continue to function in the same role, as part of [Reference Object](#referenceObject).
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Using $ref with sibling fixed fields has been deprecated. Usage without any siblings is still encouraged!
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.

From 4d113c2f7a62a8ae0645e8b070a3e122f2c81c07 Mon Sep 17 00:00:00 2001
From: Josh Ponelat <josh.ponelat@smartbear.com>
Date: Mon, 5 Sep 2022 15:29:07 +0200
Subject: [PATCH 4/6] Update asyncapi.md

---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 6c0b2d9c..44fbdbc3 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -569,7 +569,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Using $ref with sibling fixed fields has been deprecated. Usage without any siblings is still encouraged!
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Using the $ref field has been deprecated when accompanied by other fields.
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.

From 235b2420254df657cdf714eccda149bf41731609 Mon Sep 17 00:00:00 2001
From: Lukasz Gornicki <lpgornicki@gmail.com>
Date: Thu, 20 Jul 2023 17:11:36 +0200
Subject: [PATCH 5/6] Update spec/asyncapi.md

---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 44fbdbc3..1494b227 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -569,7 +569,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Using the $ref field has been deprecated when accompanied by other fields.
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for an external definition of this channel item. The referenced structure MUST be in the format of a [Channel Item Object](#channelItemObject). If there are conflicts between the referenced definition and this Channel Item's definition, the behavior is *undefined*. <br/><br/>**Deprecated:** Using the $ref property with other properties is deprecated since the 2.3.0 version of the specification.
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.

From 50dbafe3287fdd63838b5b6c1934fb8f32ee1dd4 Mon Sep 17 00:00:00 2001
From: Lukasz Gornicki <lpgornicki@gmail.com>
Date: Thu, 28 Sep 2023 09:01:23 +0200
Subject: [PATCH 6/6] fix markdown lint

---
 spec/asyncapi.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/asyncapi.md b/spec/asyncapi.md
index 641bfb79..e5781574 100644
--- a/spec/asyncapi.md
+++ b/spec/asyncapi.md
@@ -595,7 +595,7 @@ Describes the operations available on a single channel.
 
 Field Name | Type | Description
 ---|:---:|---
-<a name="channelItemObjectRef"></a>$ref | `string` | Allows for a referenced definition of this channel item. The referenced structure MUST be in the form of a [Channel Item Object](#channelItemObject). In case a Channel Item Object field appears both in the defined object and the referenced object, the behavior is *undefined*. Resolution is done as defined by the [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03). <br/><br/>**Deprecated:** Using the $ref property with other properties is deprecated since the 2.3.0 version of the specification.
+<a name="channelItemObjectRef"></a>$ref | `string` | Allows for a referenced definition of this channel item. The referenced structure MUST be in the form of a [Channel Item Object](#channelItemObject). In case a Channel Item Object field appears both in the defined object and the referenced object, the behavior is _undefined_. Resolution is done as defined by the [JSON Reference](https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03). <br/><br/>**Deprecated:** Using the $ref property with other properties is deprecated since the 2.3.0 version of the specification.
 <a name="channelItemObjectDescription"></a>description | `string` | An optional description of this channel item. [CommonMark syntax](https://spec.commonmark.org/) can be used for rich text representation.
 <a name="channelItemObjectServers"></a>servers | [`string`] | The servers on which this channel is available, specified as an optional unordered list of names (string keys) of [Server Objects](#serverObject) defined in the [Servers Object](#serversObject) (a map). If `servers` is absent or empty then this channel must be available on all servers defined in the [Servers Object](#serversObject).
 <a name="channelItemObjectSubscribe"></a>subscribe | [Operation Object](#operationObject) | A definition of the SUBSCRIBE operation, which defines the messages produced by the application and sent to the channel.