Deprecated clarfications around arrays

Author: Phil Sturgeon

jsonschema-validation.xml

@@ -1043,8 +1043,16 @@
                     is going to be removed in the future.
                 </t>
                 <t>
-                    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.
+                </t>
+                <t>
+                    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.
                 </t>
                 <t>
                     Omitting this keyword has the same behavior as a value of false.