Invalid Operation References in Example Snippets

[balogal]

Hi all,

both v2.1.0 and v2.0.0 of the specification document contain a couple of invalid example snippets. It's always the following snippet or a slight variation of it:

user/signedup:
  subscribe:
    $ref: "#/components/messages/userSignUp"

This is not valid according to the JSON schema and the specification itself since no reference object may be used in place of an Operation object. Let alone a reference to a Message object.

The snippet appears in the following sections:

• v2.1.0:
  • https://www.asyncapi.com/docs/specifications/v2.1.0#introduction
  • https://www.asyncapi.com/docs/specifications/v2.1.0#channelsObject
  • https://www.asyncapi.com/docs/specifications/v2.1.0#parametersObject
• v2.0.0:
  • https://www.asyncapi.com/docs/specifications/v2.0.0#introduction
  • https://www.asyncapi.com/docs/specifications/v2.0.0#channelsObject
  • https://www.asyncapi.com/docs/specifications/v2.0.0#parametersObject

[github-actions]

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.

Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

[fmvilas]

Good catch @balogal. Would you be open to submitting a PR?

[balogal]

Hi @fmvilas, there's already a PR opened alongside this issue.

[fmvilas]

Oh sorry, my bad. Thanks a lot 🙏 Left comments in the PR.

[smoya]

Fixed by #620