diff --git a/jsonschema-core.xml b/jsonschema-core.xml
index cd846736..b6a4222f 100644
--- a/jsonschema-core.xml
+++ b/jsonschema-core.xml
@@ -2704,9 +2704,15 @@
- The relative location of the validating keyword that follows the validation
- path. The value MUST be expressed as a JSON Pointer, and it MUST include
- any by-reference applicators such as "$ref" or "$dynamicRef".
+ The relative location of the validating keyword that follows the path
+ traversed through the schema. The value MUST be expressed as a JSON
+ Pointer, and it MUST include any by-reference applicators such as
+ "$ref" or "$dynamicRef".
+
+ The schema may not actually have a value at the location indicated
+ by this pointer. It is provided as an indication of the traversal
+ path only.
+
@@ -2720,7 +2726,7 @@
due to the inclusion of these by-reference applicator keywords.
- The JSON key for this information is "keywordLocation".
+ The JSON key for this information is "evaluationPath".
@@ -2752,7 +2758,7 @@ https://example.com/schemas/common#/$defs/count/minimum
over a reference or if the schema does not declare an absolute IRI as its "$id".
- The JSON key for this information is "absoluteKeywordLocation".
+ The JSON key for this information is "schemaLocation".
@@ -2786,13 +2792,15 @@ https://example.com/schemas/common#/$defs/count/minimum
- For the two hierarchical structures, this property will hold nested errors
- and annotations.
+ For "basic", this property will appear only at the root node and will hold
+ all errors or annotations in a list.
+
+
+ For "detailed" and "verbose", this property will hold nested errors
+ and annotations in a tree structure, mimicking that of the schema.
- The JSON key for nested results in failed validations is "errors"; for
- successful validations it is "annotations". Note the plural forms, as
- a keyword with nested results can also have a local error or annotation.
+ The JSON key for nested results is "nested".
@@ -2802,19 +2810,14 @@ https://example.com/schemas/common#/$defs/count/minimum
The output MUST be an object containing a boolean property named "valid". When
additional information about the result is required, the output MUST also contain
- "errors" or "annotations" as described below.
+ "nested" as described below.
"valid" - a boolean value indicating the overall validation success or
failure
- "errors" - the collection of errors or annotations produced by a failed
- validation
-
-
- "annotations" - the collection of errors or annotations produced by a
- successful validation
+ "nested" - the collection of errors or annotations produced by a keyword
For these examples, the following schema and instance will be used.
@@ -2910,35 +2913,35 @@ https://example.com/schemas/common#/$defs/count/minimum