diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml
index 610c18fc..281eeb7e 100644
--- a/jsonschema-validation.xml
+++ b/jsonschema-validation.xml
@@ -1043,8 +1043,14 @@
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 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
+ the corrosponding item according to the subschemas position.
Omitting this keyword has the same behavior as a value of false.