Skip to content

Commit 0d7b836

Browse files
committed
edits suggested by @handrews
1 parent 742221a commit 0d7b836

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

jsonschema-core.xml

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2756,11 +2756,11 @@
27562756
Implementations MAY elect to provide additional information.
27572757
</t>
27582758

2759-
<section title="Subschema Relative Location">
2759+
<section title="Evaluation path">
27602760
<t>
2761-
The relative location of the validating subschema that follows the path
2762-
traversed through the schema. The value MUST be expressed as a JSON
2763-
Pointer, and it MUST include any by-reference applicators such as
2761+
The location of the schema resource that produced the output unit, represented
2762+
by the path traversed during evaluation. The value MUST be expressed as a
2763+
JSON Pointer, and it MUST include any by-reference applicators such as
27642764
"$ref" or "$dynamicRef".
27652765
<cref>
27662766
The schema may not actually have a value at the location indicated
@@ -2784,12 +2784,13 @@
27842784
</t>
27852785
</section>
27862786

2787-
<section title="Subschema Absolute Location">
2787+
<section title="Subschema Location">
27882788
<t>
2789-
The absolute, dereferenced location of the validating subschema. The value MUST
2790-
be expressed as a full IRI using the canonical IRI of the relevant
2791-
schema object, and it MUST NOT include by-reference applicators
2792-
such as "$ref" or "$dynamicRef" as path components.
2789+
The absolute, dereferenced location of the schema resource that produced
2790+
the output unit. The value MUST be expressed using the canonical IRI of the
2791+
relevant schema resource plus a JSON Pointer fragment that indicates the contained
2792+
subschema that produced the output. It MUST NOT include by-reference applicators
2793+
such as "$ref" or "$dynamicRef".
27932794
<cref>
27942795
Note that "absolute" here is in the sense of "absolute filesystem path"
27952796
(meaning the complete location) rather than the "absolute-IRI"
@@ -2857,11 +2858,12 @@ https://example.com/schemas/common#/$defs/count/minimum
28572858

28582859
<section title="Nested Results">
28592860
<t>
2860-
Nested results are generated from applicator keywords: keywords with
2861-
subschemas or collections of subschemas as values. Keywords which
2862-
have arrays of subschemas (e.g. "anyOf") will generally generate an output
2863-
unit for each subschema. In order to accommodate potentially multiple
2864-
results, the value of this property MUST be an array of output units.
2861+
Nested results are generated from keywords which create a new dynamic
2862+
scope by applying a subschema to the instance or a child of the instance.
2863+
Keywords which have multiple subschemas (e.g. "anyOf") will generally
2864+
generate an output unit for each subschema. In order to accommodate
2865+
potentially multiple results, the value of this property MUST be an
2866+
array of output units, even if only a single output unit is produced.
28652867
</t>
28662868
<t>
28672869
For "basic", this property will appear only at the root output unit

0 commit comments

Comments
 (0)