Darrel

the retryAfter field in the Failure Action Object is described as "A non-negative decimal indicating the milliseconds delay". Is this really supposed to say Decimal? i.e. someone can define fractions...

It would be valuable to have some examples and discussion around the `onSuccess` property. It would be good to move the Note about what happens when there are multiple success...

OpenAPI.Net.Odata should use the ChangeTracking annotation to know if the query parameter is required. This should be transfer to that repo.

I agree that using the `{ kind: "x", type: T}` syntax in the JSON payload is the most natural approach. Regarding unnamed unions, are those only possible where JSON is...

> The license effectively tells you if/how you could re-implement and/or relicense the exposed API design. I agree with Mike's comment regarding the intent of the license. The API description...

@IMSoP I'm fine with removing the first part. I agree with 1. I think this is what the license is for. I'm not sure what is the point of publishing...

I don't really understand the first scenario you describe. The second one is how they are expected to be used and yes how the variable to value binding happens is...

Minor concern that this would prevent `*/*` as a media type. Generally supportive of this addition.

The V3 spec does provide the ability to specify multiple examples for request/response bodies using an array. However, there currently isn't a mechanism to provide a description for that example....

`http` is an extensible scheme. And it has a registry https://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml