@@ -1012,21 +1012,19 @@ resolution until runtime, at which point it is resolved each time it is
10121012encountered while evaluating an instance.
10131013
10141014Together with ` $dynamicAnchor ` , ` $dynamicRef ` implements a cooperative extension
1015- mechanism that is primarily useful with recursive schemas (schemas that
1016- reference themselves). The extension point is defined with ` $dynamicAnchor ` and
1017- only exhibits runtime dynamic behavior when referenced with ` $dynamicRef ` .
1015+ mechanism that is primarily useful to extend recursive schemas. The extension
1016+ point is defined with ` $dynamicAnchor ` and only exhibits runtime dynamic
1017+ behavior when referenced with ` $dynamicRef ` .
10181018
1019- The value of the ` $dynamicRef ` property MUST be a string which is a
1020- IRI reference that contains a valid [ plain name fragment] ( #anchors ) . Resolved
1021- against the current IRI base, it indicates the schema resource used as the
1022- starting point for runtime resolution. This initial resolution is safe to
1023- perform on schema load.
1019+ The value of the ` $dynamicRef ` property MUST be a valid
1020+ [ plain name fragment] ( #anchors ) .
10241021
1025- The schema to apply is the outermost schema resource in the [ dynamic
1026- scope] ( #scopes ) that defines a ` $dynamicAnchor ` that matches the plain name
1027- fragment in the initially resolved IRI.
1022+ Resolution of ` $dynamicRef ` begins by identifying the the outermost schema
1023+ resource in the [ dynamic scope] ( #scopes ) which defines a matching
1024+ ` $dynamicAnchor ` . The schema to apply is the subschema of this resource which
1025+ contains the matching ` $dynamicAnchor ` .
10281026
1029- For a full example using these keyword , see {{recursive-example}}.[ ^ 6 ]
1027+ For a full example using these keywords , see {{recursive-example}}.[ ^ 6 ]
10301028
10311029[ ^ 6 ] : The difference between the hyper-schema meta-schema in pre-2019 drafts and
10321030an this draft dramatically demonstrates the utility of these keywords.
0 commit comments