Skip to content

Commit

Permalink
$ref no longer effects other properties in the same object.
Browse files Browse the repository at this point in the history
Updated phrasing to align with current wording.

Resolves json-schema-org#514 and json-schema-org#523
  • Loading branch information
Relequestual committed Jun 28, 2018
1 parent c46c7da commit 7435bcb
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions jsonschema-core.xml
Original file line number Diff line number Diff line change
Expand Up @@ -955,15 +955,19 @@

<section title='Schema References With "$ref"' anchor="ref">
<t>
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.
</t>
<t>
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.
+ <t>
+ 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.
</t>
<t>
As the value of "$ref" is a URI Reference, this allows the posibility to externalise or
+ shard a schema across multiple files, and provides the ability to validate recursive structures
+ through self-reference.
+ </t>
<t>
The URI is not a network locator, only an identifier. A schema need not be
downloadable from the address if it is a network-addressable URL, and
Expand Down

0 comments on commit 7435bcb

Please sign in to comment.