Jordi Rambla

This PR requires a review from the current status

Is this PR still mergeable?

This PR is a fix, however it is breaking the specification and potentially some implementations. DO we have a policy for such cases?

@mbaudis, I believe we must consider a change as breaking if the current implementations are compliant with the current spec, BUT the change on the spec makes them not compliant...

Sorry for jumping in late in the discussion. I would like to see the actual use cases we are trying to solve here. The provided examples are not compelling to...

Is your suggestion about adding these parameters to the endpoints.yaml files?

I understand your point, @redmitry . However the difference between request and summary is there on purpose (not a strong purpose, I must say, anyway). The request SHOULD, of course,...

We need to review this PR as it seems to have some dependencies or conflicts

Agree. they are not there (yet) for two reasons: 1. OpenAPI 3.0.2 doesn't support it 2. It requires an stable path which we haven't agreed upon yet. Should we simply...

@redmitry @datsirul I've been confused by the $id in the Json Schemas, the actual usefulness and its compatibility with OA... Do you have insights or opinions on this topic?