Skip to content

Commit aa8599a

Browse files
committed
clean up $dyanmic*
1 parent 4b21ddd commit aa8599a

File tree

1 file changed

+10
-12
lines changed

1 file changed

+10
-12
lines changed

specs/jsonschema-core.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1012,21 +1012,19 @@ resolution until runtime, at which point it is resolved each time it is
10121012
encountered while evaluating an instance.
10131013

10141014
Together 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
10321030
an this draft dramatically demonstrates the utility of these keywords.

0 commit comments

Comments
 (0)