Darrel
@cyberphone If you want to keep all of your security related information in a JSON payload, then OpenAPI is quite capable of describing that. The Schema Object can describe the...
spec.openapis.org is not directly tied to the OpenAPI specification any more as we are using that site for a variety of purposes. We think that it is fine to leave...
@webron As a mostly irrelevant datapoint, the OpenAPI parser that I work on does not support referencing anything internally that is not inside components. If someone wants to do that,...
The specification is not clear enough to make the claim that you cannot $ref to non-components. But I would caution authors that some tooling may not support these $refs and...
Tooling uses OperationId fairly extensively. Readable OperationIds are generally preferred as it makes it easier to hand edit documents.
I really wish Description wasn't required.
Thanks. Will investigate.
Sorry for the slow response. I believe the issue is resolved in this project https://github.com/Microsoft/OpenAPI.NET A nuget will be published soon.
Thanks for the feedback. Sorry for the slow response. This project has morphed into https://github.com/Microsoft/OpenAPI.NET Future work will be happening there.
Swagger UI added V3 support a few weeks ago. https://github.com/swagger-api/swagger-ui/releases I'm currently working on adding support to Azure API Management.