Skip to content

Commit ef9279d

Browse files
committed
Add intro material to unevaluated applicator vocab
This attempts to address various points of confusion noted in feedback on the most recent draft.
1 parent 917f22c commit ef9279d

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

jsonschema-core.xml

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2478,6 +2478,28 @@
24782478
</section>
24792479

24802480
<section title="A Vocabulary for Unevaluated Locations">
2481+
<t>
2482+
The purpose of these keywords is to enable schema authors to apply
2483+
subschemas to array items or object properties that have not been
2484+
successfully evaluated against any dynamic-scope subschema of any
2485+
adjacent keywords.
2486+
</t>
2487+
<t>
2488+
These instance items or properties may have been unsuccessfully evaluated
2489+
against one or more adjacent keyword subschemas, such as when an assertion
2490+
in a branch of an "anyOf" fails. Such failed evaluations are not considered
2491+
to contribute to whether or not the item or property has been evaluated.
2492+
Only successful evaluations are considered.
2493+
</t>
2494+
<t>
2495+
Recall that adjacent keywords are keywords within the same schema object,
2496+
and that the dynamic-scope subschemas include reference targets as well as
2497+
lexical subschemas.
2498+
</t>
2499+
<t>
2500+
The behavior of these keywords depend on the annotation results of
2501+
adjacent keywords that apply to the instance location being validated.
2502+
</t>
24812503
<t>
24822504
Meta-schemas that do not use "$vocabulary" SHOULD be considered to
24832505
require this vocabulary as if its URI were present with a value of true.

0 commit comments

Comments
 (0)