-
Notifications
You must be signed in to change notification settings - Fork 20
Description
This is perhaps two different issues in one.
The info in openapi.json is identical to the info in openapi_preview.json, providing no way to programmatically distinguish specs by anything other than filename. More specifically, the two current specs are both titled and described as "Preview" while only one has a _preview suffix in its filename.
Additionally, the version field is used incorrectly.
From https://spec.openapis.org/oas/v3.1.0.html#info-object:
REQUIRED. The version of the OpenAPI document (which is distinct from the OpenAPI Specification version or the API implementation version).
From https://spec.openapis.org/oas/v3.1.1.html#info-object (latest version):
REQUIRED. The version of the OpenAPI Document (which is distinct from the OpenAPI Specification version or the version of the API being described or the version of the OpenAPI Description).
Because version is set to the API version (10), the only way to distinguish between document versions is by git commit hash.