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