rest-guide icon indicating copy to clipboard operation
rest-guide copied to clipboard
verified publisher icon belgif

CloudEvent guidelines

Open pvdbosch opened this issue 6 months ago • 1 comments

Add guidelines on AsyncAPI/OpenAPI and the use of openapi-cloudevents

This covers these two issues:

  • https://github.com/belgif/openapi-cloudevents/issues/2
  • https://github.com/belgif/openapi-cloudevents/issues/11

pvdbosch avatar Jun 12 '25 10:06 pvdbosch

REST guide WG:

  • guideline on OpenAPI/AsyncAPI is OK, but more clearly explain grouping of event definitions using single entry document
  • merging will wait on remaining discussion on CloudEventBase (include 'type' or not) and related recommendations around inheritance and polymorphism. (https://github.com/belgif/rest-guide/issues/181)

pvdbosch avatar Jun 13 '25 14:06 pvdbosch

REST guide WG reviewed PR, OK to merge and publish.

pvdbosch avatar Nov 21 '25 14:11 pvdbosch