diff --git a/jsonschema-core.xml b/jsonschema-core.xml index 60a976f0..508266db 100644 --- a/jsonschema-core.xml +++ b/jsonschema-core.xml @@ -955,14 +955,18 @@
- The "$ref" keyword is used to reference a schema, and provides the ability to - validate recursive structures through self-reference. + The "$ref" keyword can be used to reference a schema which is to be applied to the + current instance location. "$ref" is an applicator key word, applying the referred + schema to the instance. - An object schema with a "$ref" property MUST be interpreted as a "$ref" reference. - The value of the "$ref" property MUST be a URI Reference. + The value of the "$ref" property MUST be a string which is a URI Reference. Resolved against the current URI base, it identifies the URI of a schema to use. - All other properties in a "$ref" object MUST be ignored. + + + As the value of "$ref" is a URI Reference, this allows the possibility to externalise or + divide a schema across multiple files, and provides the ability to validate recursive structures + through self-reference. The URI is not a network locator, only an identifier. A schema need not be