This release brings no significant changes, but a valuable selection of updates and improvements in the specification text, including: corrections and clarifications to the table of Style Examples (used in parameter encoding) additional notes on in/style/explode combinations that are prohibited, namely: in: cookie, style: form, explode: false with arrays or objects style: form, explode: true with…
Headline features Multipurpose tags, with nesting summary field to allow short descriptions, used when displaying lists of tags. parent field to point to the tag that this tag is nested under. kind field to allow a tag to be classified into a category such as navigation, or audience. The kind field is free-form text, however there are some expected/conventional values such as nav (in line with the…
Archiving branch v3.0-dev-wip because v3.0 is not under active mainte…
Contents have moved to https://github.com/OAI/spec.openapis.org
Version 3.1.2 has no material changes but does contain editorial fixes, additional examples, and clarifications. Clarify that $ref in a Schema Object is a JSON Schema $ref keyword. Detailed explanation of percent-encoding and -decoding, updated examples and references to match, including the Style Examples table. Better explanation and examples for using Encoding and Serialization, and a note not…
Archiving branch v3.2.0-dev from a previous branching strategy
Archiving branch v3.1.1-dev from a previous branching strategy
Archiving branch v3.0.4-dev from a previous branching strategy
v3.1.0 schemas are published
Release Notes While the 3.1.1 release makes no changes to requirements of the OpenAPI 3.1.0 specification, it does introduce a number of notable improvements, including: Expands and clarifies a number of explanations, including several new appendices with supplementary details Focuses on technical specifics by moving examples and additional documentation now published at learn.openapis.org Declare…
Release Notes While the 3.0.4 release makes no changes to requirements of the OpenAPI 3.0.3 specification, it does introduce a number of notable improvements, including: Expands and clarifies a number of explanations, including several new appendices with supplementary details Focuses on technical specifics by moving examples and additional documentation now published at learn.openapis.org Declare…