Open
Description
It would be great to have a way to flag that a channel is deprecated or is going to disappear/sunset at some point. We already thought about a property like deprecated: true
but that would be insufficient if we want to understand when the channel is going to finally disappear and what alternatives do I have.
I thought on something like this, following a bit the idea behind the sunset header definition for HTTP by @dret.
deprecated: true
sunset:
datetime: 2020-01-21T18:33:19Z # Optional
message: Stop using it now! # Optional
externalDocs: myjira.com/issue-7 # Optional (Thanks Michael Davis)
alternativeChannel: /alternative/channel/name # Optional
I'm sure some folks over at JSON Schema and OpenAPI already had this discussion. Any thoughts? @philsturgeon @MikeRalphson @Relequestual
Source of discussion here: https://asyncapi.slack.com/archives/C34F2JV0U/p1579542224002900