While $comment is a valid JSON schema (2020 release), it is not supported by Speccy or Spectral lint actions (perhaps because we are not yet on OpenAPI 3.1, but regardless).
It was easier just to move these $comment attributes into the accompanying text description.
While
$commentis a valid JSON schema (2020 release), it is not supported by Speccy or Spectral lint actions (perhaps because we are not yet on OpenAPI 3.1, but regardless).It was easier just to move these $comment attributes into the accompanying text description.