Skip to content

Commit d60384b

Browse files
committed
chore: attempt at a OAS3.1 metaschema
1 parent e40bc02 commit d60384b

File tree

3 files changed

+2284
-0
lines changed

3 files changed

+2284
-0
lines changed

schemas/v3.1/README.md

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
OpenAPI 3.1.X JSON Schema
2+
---
3+
4+
Here you can find the JSON Schema for validating OpenAPI definitions of versions 3.1.X.
5+
6+
As a reminder, the JSON Schema is not the source of truth for the Specification. In cases of conflicts between the Specification itself and the JSON Schema, the Specification wins. Also, some Specification constraints cannot be represented with the JSON Schema so it's highly recommended to employ other methods to ensure compliance.
7+
8+
The iteration version of the JSON Schema can be found in the `$id` field. For example, the value of `$id: https://spec.openapis.org/oas/3.1/schema/2021-02-18` means this iteration was created on February 18th, 2021.
9+
10+
To submit improvements to the schema, modify the schema.yaml file only.
11+
12+
The TSC will then:
13+
- Run tests on the updated schema
14+
- Update the iteration version
15+
- Convert the schema.yaml to schema.json
16+
- Publish the new version

0 commit comments

Comments
 (0)