Skip to content

Commit 086ffd5

Browse files
author
Phil Sturgeon
committed
Ron's wording for Darrels feedback
1 parent ed209dc commit 086ffd5

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

versions/3.0.3.md

+2
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,8 @@ The OpenAPI Specification is versioned using [Semantic Versioning 2.0.0](https:/
102102

103103
The `major`.`minor` portion of the semver (for example `3.0`) SHALL designate the OAS feature set. Typically, *`.patch`* versions address errors in this document, not the feature set. Tooling which supports OAS 3.0 SHOULD be compatible with all OAS 3.0.\* versions. The patch version SHOULD NOT be considered by tooling, making no distinction between `3.0.0` and `3.0.1` for example.
104104

105+
If an OAS definition has its minor version incremented, it MUST still be a valid definition for the new minor version. E.g., if we have a document that is 3.0.2 and we change the version to 3.1.0, then it MUST be a valid 3.1.0 document.
106+
105107
An OpenAPI document compatible with OAS 3.\*.\* contains a required [`openapi`](#oasVersion) field which designates the semantic version of the OAS that it uses. (OAS 2.0 documents contain a top-level version field named [`swagger`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#swaggerObject) and value `"2.0"`.)
106108

107109
### Format

0 commit comments

Comments
 (0)