File tree Expand file tree Collapse file tree 1 file changed +12
-4
lines changed Expand file tree Collapse file tree 1 file changed +12
-4
lines changed Original file line number Diff line number Diff line change @@ -547,10 +547,18 @@ Since `contentMediaType` is required to provide instruction on how to interpret
547
547
string content, the annotation schema produced by this keyword has no meaning if
548
548
` contentMediaType ` is not present.
549
549
550
- Accessing the schema through the schema location IRI included as part of the
551
- annotation will ensure that it is correctly processed as a subschema. Using the
552
- extracted annotation value directly is only safe if the subschema is an embedded
553
- resource with both ` $schema ` and an absolute IRI ` $id ` .
550
+ Note that evaluating the ` contentSchema ` subschema in-place (i.e. as part of its
551
+ parent schema) will ensure that it is correctly processed. Independent use of
552
+ the extracted subschema (as returned in an annotation) is only safe if the
553
+ subschema is an embedded reource which defines both a ` $schema ` and an absolute
554
+ IRI ` $id ` .[ ^ 7 ]
555
+
556
+ [ ^ 7 ] Processing a non-resource subschema in place will ensure that any
557
+ references (e.g. ` $ref ` ) are always resolved properly. This isn't a problem when
558
+ the subschema is itself a resource. See
559
+ https://github.com/json-schema-org/json-schema-spec/issues/1381 for several
560
+ examples where processing this subschema independently can cause ` $ref `
561
+ resolution failure.
554
562
555
563
### Example
556
564
You can’t perform that action at this time.
0 commit comments