zalando / restful-api-guidelines

A model set of guidelines for RESTful APIs and Events, created by Zalando
https://opensource.zalando.com/restful-api-guidelines/
Creative Commons Attribution 4.0 International
2.61k stars 384 forks source link

clarity on x-extensible-enum usage for events #807

Closed tfrauenstein closed 2 months ago

a1exsh commented 4 months ago

When I think about it, the x-extensible-enum gives a stronger signal to the event publishers: namely, the set of currently accepted values.

For the event consumers, in turn, it only signifies the list of currently most commonly found values, but does not restrict the future or the past set of possible values in any way. In that regard it's not much different from a free-form string with examples provided.

a1exsh commented 4 months ago

:+1:

tkrop commented 3 months ago

👍

ePaul commented 2 months ago

@tfrauenstein wanted to extend the PR as discussed in the Meeting (internal link)

tfrauenstein commented 2 months ago

done

tfrauenstein commented 2 months ago

👍

tkrop commented 2 months ago

👍