Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
eab08e9
Explain that schemas are for mandatory requirements
handrews Jan 22, 2026
d6655e1
Remove 1st paragraph (review feedback)
handrews Jan 26, 2026
8e6eef6
Bump cheerio from 1.1.2 to 1.2.0
dependabot[bot] Jan 26, 2026
37df1c9
Merge pull request #5183 from handrews/nolint
handrews Jan 29, 2026
23016b3
Merge main into dev-sync-with-main
github-actions[bot] Jan 29, 2026
2807c82
Bump the vitest group with 2 updates
dependabot[bot] Jan 30, 2026
6e88061
Merge pull request #5187 from OAI/dependabot/npm_and_yarn/vitest-0735…
ralfhandl Jan 30, 2026
fe62063
Merge main into dev-sync-with-main
github-actions[bot] Jan 30, 2026
e33c815
Bump respec from 35.6.1 to 35.7.0
dependabot[bot] Feb 23, 2026
3d083ef
Bump c8 from 10.1.3 to 11.0.0
dependabot[bot] Feb 25, 2026
08f7665
Merge pull request #5222 from OAI/dependabot/npm_and_yarn/c8-11.0.0
ralfhandl Feb 27, 2026
41cac7b
Merge main into dev-sync-with-main
github-actions[bot] Feb 27, 2026
9001070
Bump markdownlint-cli2 from 0.20.0 to 0.21.0
dependabot[bot] Feb 27, 2026
ae319a0
Merge pull request #5207 from OAI/dependabot/npm_and_yarn/markdownlin…
ralfhandl Feb 27, 2026
939f402
Merge main into dev-sync-with-main
github-actions[bot] Feb 27, 2026
cdb3984
Merge pull request #5210 from OAI/dependabot/npm_and_yarn/respec-35.7.0
ralfhandl Feb 27, 2026
aae4eab
Merge main into dev-sync-with-main
github-actions[bot] Feb 27, 2026
d695bf2
Merge branch 'main' into dependabot/npm_and_yarn/cheerio-1.2.0
ralfhandl Feb 27, 2026
e664668
Merge pull request #5189 from OAI/dependabot/npm_and_yarn/cheerio-1.2.0
ralfhandl Feb 27, 2026
03ed04f
Merge main into dev-sync-with-main
github-actions[bot] Feb 27, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,19 @@ Schemas are updated in and directly published from the `vX.Y-dev` branches.

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.

#### Schemas and OAS Requirements

The schemas published by the OpenAPI Initiative _only_ validate mandatory
OAS requirements. This means that a field value or combination with another
field is only forbidden in a schema if there is a corresponding MUST / MUST NOT /
SHALL / SHALL NOT requirement that prevents it.

Schemas that apply further restrictions to enforce desired usage are outside
of the scope of the OpenAPI Initiative. When opening an issue or PR for
schema changes, please ensure that the changes are backed by clear OAS
requirements. Otherwise, the issue or PR will be closed with a note pointing
to this section.

## Release Process and Scope

This section relates to the 3.x versions only.
Expand Down
Loading