@@ -452,8 +452,8 @@ The lexical scope of a keyword is determined by the nested JSON data structure
452
452
of objects and arrays. The largest such scope is an entire schema document. The
453
453
smallest scope is a single schema object with no subschemas.
454
454
455
- Keywords MAY be defined with a partial value, such as a IRI- reference, which
456
- must be resolved against another value, such as another IRI- reference or a full
455
+ Keywords MAY be defined with a partial value, such as a IRI reference, which
456
+ must be resolved against another value, such as another IRI reference or a full
457
457
IRI, which is found through the lexical structure of the JSON document. The
458
458
` $id ` , ` $ref ` , and ` $dynamicRef ` core keywords, and the "base" JSON Hyper-Schema
459
459
keyword, are examples of this sort of behavior.
@@ -542,7 +542,7 @@ Identifiers define IRIs for a schema, or affect how such IRIs are resolved in
542
542
keywords, most notably ` $id ` .
543
543
544
544
Canonical schema IRIs MUST NOT change while processing an instance, but keywords
545
- that affect IRI- reference resolution MAY have behavior that is only fully
545
+ that affect IRI reference resolution MAY have behavior that is only fully
546
546
determined at runtime.
547
547
548
548
While custom identifier keywords are possible, extension designers should take
@@ -898,8 +898,8 @@ To differentiate between schemas in a vast ecosystem, schemas are identified by
898
898
[ IRI] ( #rfc3987 ) , and can embed references to other schemas by specifying their
899
899
IRI.
900
900
901
- Several keywords can accept a relative [ IRI- reference] ( #rfc3987 ) , or a value
902
- used to construct a relative IRI- reference. For these keywords, it is necessary
901
+ Several keywords can accept a relative [ IRI reference] ( #rfc3987 ) , or a value
902
+ used to construct a relative IRI reference. For these keywords, it is necessary
903
903
to establish a base IRI in order to resolve the reference.
904
904
905
905
#### The ` $id ` Keyword {#id-keyword}
@@ -912,10 +912,10 @@ the case of a network-addressable URL, a schema need not be downloadable from
912
912
its canonical IRI.
913
913
914
914
If present, the value for this keyword MUST be a string, and MUST represent a
915
- valid [ IRI- reference] ( #rfc3987 ) . This IRI- reference SHOULD be normalized, and
916
- MUST resolve to an [ absolute- IRI] ( #rfc3987 ) (without a fragment).
915
+ valid [ IRI reference] ( #rfc3987 ) . This IRI reference SHOULD be normalized, and
916
+ MUST resolve to an [ absolute IRI] ( #rfc3987 ) (without a fragment).
917
917
918
- The resulting absolute- IRI serves as the base IRI for relative IRI- references in
918
+ The resulting absolute IRI serves as the base IRI for relative IRI references in
919
919
keywords within the schema resource, in accordance with [ RFC 3987 section
920
920
6.5] ( #rfc3987 ) and [ RFC 3986 section 5.1.1] ( #rfc3986 ) regarding base IRIs
921
921
embedded in content.
@@ -924,7 +924,7 @@ The presence of `$id` in a subschema indicates that the subschema constitutes a
924
924
distinct schema resource within a single schema document. Furthermore, in
925
925
accordance with [ RFC 3987 section 6.5] ( #rfc3987 ) and [ RFC 3986 section
926
926
5.1.2] ( #rfc3986 ) regarding encapsulating entities, if an ` $id ` in a subschema is
927
- a relative IRI- reference, the base IRI for resolving that reference is the IRI
927
+ a relative IRI reference, the base IRI for resolving that reference is the IRI
928
928
of the parent schema resource. Note that an ` $id ` consisting of an empty IRI or
929
929
of the empty fragment only will result in the embedded resource having the same
930
930
IRI as the encapsulating resource, which SHOULD be considered an error per
@@ -937,7 +937,7 @@ given in the [previous section.](initial-base)
937
937
##### Identifying the root schema
938
938
939
939
The root schema of a JSON Schema document SHOULD contain an ` $id ` keyword with
940
- an [ absolute- IRI] ( #rfc3987 ) (containing a scheme, but no fragment).
940
+ an [ absolute IRI] ( #rfc3987 ) (containing a scheme, but no fragment).
941
941
942
942
#### Defining location-independent identifiers {#anchors}
943
943
@@ -971,7 +971,7 @@ If present, the value of these keywords MUST be a string and MUST conform to the
971
971
plain name fragment identifier syntax defined in {{fragments}}.[ ^ 4 ]
972
972
973
973
[ ^ 4 ] : Note that the anchor string does not include the "#" character, as it is
974
- not a IRI- reference. An ` $anchor ` : "foo" becomes the fragment ` #foo ` when used
974
+ not a IRI reference. An ` $anchor ` : "foo" becomes the fragment ` #foo ` when used
975
975
in a IRI. See below for full examples.
976
976
977
977
#### Duplicate schema identifiers {#duplicate-iris}
@@ -1005,7 +1005,7 @@ identified schema. Its results are the results of the referenced schema.[^5]
1005
1005
[ ^ 5 ] : Note that this definition of how the results are determined means that
1006
1006
other keywords can appear alongside of ` $ref ` in the same schema object.
1007
1007
1008
- The value of the ` $ref ` keyword MUST be a string which is a IRI-Reference .
1008
+ The value of the ` $ref ` keyword MUST be a string which is a IRI reference .
1009
1009
Resolved against the current IRI base, it produces the IRI of the schema to
1010
1010
apply. This resolution is safe to perform on schema load, as the process of
1011
1011
evaluating an instance cannot change how the reference resolves.
@@ -1022,7 +1022,7 @@ reference themselves). The extension point is defined with `$dynamicAnchor` and
1022
1022
only exhibits runtime dynamic behavior when referenced with ` $dynamicRef ` .
1023
1023
1024
1024
The value of the ` $dynamicRef ` property MUST be a string which is a
1025
- IRI-Reference that contains a valid [ plain name fragment] ( #anchors ) . Resolved
1025
+ IRI reference that contains a valid [ plain name fragment] ( #anchors ) . Resolved
1026
1026
against the current IRI base, it indicates the schema resource used as the
1027
1027
starting point for runtime resolution. This initial resolution is safe to
1028
1028
perform on schema load.
@@ -2284,9 +2284,9 @@ simplify coding so that various invocations of JSON Schema libraries do not have
2284
2284
to keep track of and load a large number of resources.
2285
2285
2286
2286
This transformation can be safely and reversibly done as long as all static
2287
- references (e.g. ` $ref ` ) use IRI- references that resolve to IRIs using the
2287
+ references (e.g. ` $ref ` ) use IRI references that resolve to IRIs using the
2288
2288
canonical resource IRI as the base, and all schema resources have an
2289
- absolute- IRI as the ` $id ` in their root schema.
2289
+ absolute IRI as the ` $id ` in their root schema.
2290
2290
2291
2291
With these conditions met, each external resource can be copied under ` $defs ` ,
2292
2292
without breaking any references among the resources' schema objects, and without
@@ -2470,7 +2470,7 @@ to the document.
2470
2470
- Clarify that detecting duplicate IRIs for different schemas SHOULD raise an
2471
2471
error
2472
2472
- Consolidate and clarify the syntax and rationale for plain-name fragments
2473
- - "$id" MUST be an absolute- IRI, without any fragment, even an empty one
2473
+ - "$id" MUST be an absolute IRI, without any fragment, even an empty one
2474
2474
- Note that an empty string "$id" results in duplicate IRIs for different
2475
2475
schemas
2476
2476
- Define empty schemas as empty (no longer allowing unrecognized keywords)
0 commit comments