Darrel

I'm confused as to why there is a suggestion that actions/functions are related to performing operations on multiple resources. I don't see any correlation to how many resources are affected....

I get the feeling that there are a number of constraints on the webhooks guidance that are in additional to the regular API guidance and wonder if are essential. I'm...

Based on conversations with a number of people, it seems logical to favour 201 over 204 in the case where something has been created and it has no body. A...

I guess I should write a PR. /cc Thoughts? @garethj-msft @RobDolinMS @markdstafford

Thanks for the update. I wasn't involved when the original guidelines were being written but I'm guessing that many different sources were used to derive these guidelines.

@garethj-msft You are correct, we dropped that. I guess I read what I expected to read. I didn't expect the guidelines to enforce a query parameter name. I see the...

It is important to remember that JSON Schema has no notion of whether it is being used for request validation or response validation. If you want to enforce a create...

@jdesrosiers The challenge with making url or identifier required is that it would be breaking from v3.0 where url was not required and identifier didn't exist. https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#license-object We should probably...

@dimonomid Not allowing unescaped slashes in parameter values is for the same reason we don't allow optional path segments. Some tooling needs to be able to deterministically map a URL...

My understanding is that some frameworks don't address it, some do, but many do it in different ways. There is no standardized algorithm for deciding on the right match. Even...