From 91c198ec33b4595fd2b55e01af11e27feacac27b Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Sun, 16 Jun 2019 21:01:40 +0200 Subject: [PATCH 1/7] Deprecated clarfications around arrays --- jsonschema-validation.xml | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 610c18fc..416946b0 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1043,8 +1043,16 @@ is going to be removed in the future. - A root schema containing "deprecated" with a value of true indicates the entire - root schema MAY be removed in the future. + A root schema containing "deprecated" with a value of true indicates that + the entire resource beng described MAY be removed in the future. + + + When the "deprecated" keyword is used to describe an array, it can be used + in the tuple form to deprecate positional schemas. If "deprecated" is used + in the list form it can mark regular "items" as deprecated, whilst allowing + "additionalItems". Vice verse, setting "deprecated" to true inside + "additionalItems" would mark the additional items as deprecated, but not + effect list usage. Omitting this keyword has the same behavior as a value of false. From db5a50cda5b1bb960ff254f9497695aa1ced2b20 Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Thu, 20 Jun 2019 15:25:46 +0200 Subject: [PATCH 2/7] no more tuple --- jsonschema-validation.xml | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 416946b0..77fff604 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1047,12 +1047,10 @@ the entire resource beng described MAY be removed in the future. - When the "deprecated" keyword is used to describe an array, it can be used - in the tuple form to deprecate positional schemas. If "deprecated" is used - in the list form it can mark regular "items" as deprecated, whilst allowing - "additionalItems". Vice verse, setting "deprecated" to true inside - "additionalItems" would mark the additional items as deprecated, but not - effect list usage. + When the "deprecated" keyword is used to describe an array, it's meaning will + vary depending on how "items" is used. If "items" is a single schema, it will + deprecate the contents of an array, but if "items" is an array of schemas it + can be used to deprecate positional schemas. Omitting this keyword has the same behavior as a value of false. From 58e372cbfa05a724c625606863bc94d053c10ed5 Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Fri, 19 Jul 2019 16:09:59 +0100 Subject: [PATCH 3/7] Fix typo! --- jsonschema-validation.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 77fff604..c8cadcd4 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1044,7 +1044,7 @@ A root schema containing "deprecated" with a value of true indicates that - the entire resource beng described MAY be removed in the future. + the entire resource being described MAY be removed in the future. When the "deprecated" keyword is used to describe an array, it's meaning will From 92301ba447a837cf67016e74f9aafc7fee4fd0d0 Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Fri, 19 Jul 2019 17:12:13 +0200 Subject: [PATCH 4/7] applied applicability --- jsonschema-validation.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index c8cadcd4..e5bf9deb 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1047,7 +1047,7 @@ the entire resource being described MAY be removed in the future. - When the "deprecated" keyword is used to describe an array, it's meaning will + When the "deprecated" keyword is applicable to an array, it's meaning will vary depending on how "items" is used. If "items" is a single schema, it will deprecate the contents of an array, but if "items" is an array of schemas it can be used to deprecate positional schemas. From 925b18ce66f0c30b0efc56cbfcc2e6759e2ad13f Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Mon, 19 Aug 2019 14:32:33 +0200 Subject: [PATCH 5/7] attempt at clarification --- jsonschema-validation.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index e5bf9deb..031de5fb 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1050,7 +1050,7 @@ When the "deprecated" keyword is applicable to an array, it's meaning will vary depending on how "items" is used. If "items" is a single schema, it will deprecate the contents of an array, but if "items" is an array of schemas it - can be used to deprecate positional schemas. + should be defined in the sub-schema targetted for deprecation. Omitting this keyword has the same behavior as a value of false. From 55d9467e363dd67e1e0b717de104ab667f427822 Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Mon, 19 Aug 2019 17:59:16 +0200 Subject: [PATCH 6/7] nailed it this time --- jsonschema-validation.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 031de5fb..c964b55b 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1047,10 +1047,10 @@ the entire resource being described MAY be removed in the future. - When the "deprecated" keyword is applicable to an array, it's meaning will - vary depending on how "items" is used. If "items" is a single schema, it will - deprecate the contents of an array, but if "items" is an array of schemas it - should be defined in the sub-schema targetted for deprecation. + When the deprecated keyword is applied to an item in an array by means of + items, if items is a single schema, the deprecation relates to the whole + array, while if items is an array of schemas, the deprecation relates to + the corrosponding item according to the subschemas position. Omitting this keyword has the same behavior as a value of false. From e463e1e29a907d250eabff5fd3f3786de92bb7fa Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Mon, 2 Sep 2019 23:01:01 +0100 Subject: [PATCH 7/7] Add quotes back --- jsonschema-validation.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index c964b55b..281eeb7e 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -1047,9 +1047,9 @@ the entire resource being described MAY be removed in the future. - When the deprecated keyword is applied to an item in an array by means of - items, if items is a single schema, the deprecation relates to the whole - array, while if items is an array of schemas, the deprecation relates to + When the "deprecated" keyword is applied to an item in an array by means of + "items", if "items" is a single schema, the deprecation relates to the whole + array, while if "items" is an array of schemas, the deprecation relates to the corrosponding item according to the subschemas position.