From 6cd604e70d122dd9eefb34bbda53774e34e38f5c Mon Sep 17 00:00:00 2001 From: Darrel Miller Date: Fri, 28 Aug 2020 17:02:57 -0400 Subject: [PATCH 1/3] Added words relating to adopting semantics of JSON Schema --- versions/3.1.0.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 23dca9cd5a..65658f8a58 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2284,11 +2284,13 @@ $ref: definitions.yaml#/Pet #### Schema Object -The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is a superset of the [JSON Schema Specification Draft 2019-09](http://json-schema.org/). +The Schema Object allows the definition of input and output data types. +These types can be objects, but also primitives and arrays. This object is a superset of the [JSON Schema Specification Draft 2019-09](http://json-schema.org/). For more information about the properties, see [JSON Schema Core](https://json-schema.org/draft/2019-09/json-schema-core.html) and [JSON Schema Validation](https://json-schema.org/draft/2019-09/json-schema-validation.html). -Unless stated otherwise, the property definitions follow the JSON Schema. +Unless stated otherwise, the property definitions follow the JSON Schema and does not add any additional semantics. +Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI description. ##### Properties From ed9985d0c01b2d93ce6aa972a370931b7cb48201 Mon Sep 17 00:00:00 2001 From: Darrel Date: Thu, 1 Oct 2020 12:43:28 -0400 Subject: [PATCH 2/3] Update versions/3.1.0.md Co-authored-by: Mike Ralphson --- versions/3.1.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 65658f8a58..ea1d354bb4 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2289,7 +2289,7 @@ These types can be objects, but also primitives and arrays. This object is a sup For more information about the properties, see [JSON Schema Core](https://json-schema.org/draft/2019-09/json-schema-core.html) and [JSON Schema Validation](https://json-schema.org/draft/2019-09/json-schema-validation.html). -Unless stated otherwise, the property definitions follow the JSON Schema and does not add any additional semantics. +Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI description. ##### Properties From e02548d9e7cc3e47518da427e00308d1d2181dc9 Mon Sep 17 00:00:00 2001 From: Darrel Date: Thu, 8 Oct 2020 12:07:59 -0400 Subject: [PATCH 3/3] Update versions/3.1.0.md Co-authored-by: Mike Ralphson --- versions/3.1.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index ea1d354bb4..c18375f7ee 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2290,7 +2290,7 @@ These types can be objects, but also primitives and arrays. This object is a sup For more information about the properties, see [JSON Schema Core](https://json-schema.org/draft/2019-09/json-schema-core.html) and [JSON Schema Validation](https://json-schema.org/draft/2019-09/json-schema-validation.html). Unless stated otherwise, the property definitions follow those of JSON Schema and do not add any additional semantics. -Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI description. +Where JSON Schema indicates that behavior is defined by the application (e.g. for annotations), OAS also defers the definition of semantics to the application consuming the OpenAPI document. ##### Properties