diff --git a/jsonschema-core.xml b/jsonschema-core.xml index 25b0e605..3f99e8e8 100644 --- a/jsonschema-core.xml +++ b/jsonschema-core.xml @@ -1587,7 +1587,14 @@
- The "$ref" keyword is used to reference a statically identified schema. + The "$ref" keyword is an applicator that is used to reference a statically + identified schema. Its results are the results of the referenced schema. + + Note that this definition of how the results are determined means that + other keywords can appear alongside of "$ref" in the same schema object. + + + The value of the "$ref" property MUST be a string which is a URI-Reference. Resolved against the current URI base, it produces the URI of the schema to apply. @@ -1653,6 +1660,10 @@ when it is present), "$recursiveRef"'s behavior is identical to that of "$ref". + + As with "$ref", the results of this keyword are the results of the + referenced schema. +