Skip to content

Commit 2d73411

Browse files
committed
docs: makes minor versions non breaking
1 parent c82e017 commit 2d73411

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

src/oas.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -147,15 +147,15 @@ Unlike undefined behavior, it is safe to rely on implementation-defined behavior
147147

148148
The OpenAPI Specification is versioned using a `major`.`minor`.`patch` versioning scheme. The `major`.`minor` portion of the version string (for example `3.1`) SHALL designate the OAS feature set. _`.patch`_ versions address errors in, or provide clarifications to, this document, not the feature set. Tooling which supports OAS 3.1 SHOULD be compatible with all OAS 3.1.\* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between `3.1.0` and `3.1.1` for example.
149149

150-
Occasionally, non-backwards compatible changes may be made in `minor` versions of the OAS where impact is believed to be low relative to the benefit provided.
150+
New `minor` or `patch` versions after 3.1 WILL NOT introduce non-backwards compatible changes.
151151

152152
### Deprecation
153153

154154
Certain fields or features may be marked **Deprecated**.
155155
These fields and features remain part of the specification and can be used like any other field or feature.
156156
However, OpenAPI Description authors should use newer fields and features documented to replace the deprecated ones whenever possible.
157157

158-
At this time, such elements are expected to remain part of the OAS until the next major version, although a future minor version of this specification may define a policy for later removal of deprecated elements.
158+
At this time, such elements are expected to remain part of the OAS until the next major version.
159159

160160
### Format
161161

0 commit comments

Comments
 (0)