Skip to content

Commit 92e8ec5

Browse files
authored
Merge pull request #5192 from OAI/dev-sync-with-main
dev: sync with main
2 parents f39f7f0 + 1ab26a7 commit 92e8ec5

File tree

3 files changed

+403
-446
lines changed

3 files changed

+403
-446
lines changed

CONTRIBUTING.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -257,6 +257,19 @@ Schemas are updated in and directly published from the `vX.Y-dev` branches.
257257

258258
As part of the publishing process, the YAML source files are converted to JSON, renamed to the relevant last-changed dates, and `WORK-IN-PROGRESS` placeholders are replaced with these dates as appropriate. This is usually done by the [`schema-publish` workflow](https://github.com/OAI/OpenAPI-Specification/blob/main/.github/workflows/schema-publish.yaml) which detects changes on each `vX.Y-dev` branch, which generates a pull request for publishing the new schema iterations to the [spec site](https://spec.openapis.org). The workflow can also be run manually if required.
259259

260+
#### Schemas and OAS Requirements
261+
262+
The schemas published by the OpenAPI Initiative _only_ validate mandatory
263+
OAS requirements. This means that a field value or combination with another
264+
field is only forbidden in a schema if there is a corresponding MUST / MUST NOT /
265+
SHALL / SHALL NOT requirement that prevents it.
266+
267+
Schemas that apply further restrictions to enforce desired usage are outside
268+
of the scope of the OpenAPI Initiative. When opening an issue or PR for
269+
schema changes, please ensure that the changes are backed by clear OAS
270+
requirements. Otherwise, the issue or PR will be closed with a note pointing
271+
to this section.
272+
260273
## Release Process and Scope
261274

262275
This section relates to the 3.x versions only.

0 commit comments

Comments
 (0)