Skip to content

Ref is delegation - try 3 #628

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 30, 2018
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
$ref no longer effects other properties in the same object.
Updated phrasing to align with current wording.

Resolves #514 and #523
  • Loading branch information
Relequestual committed Jun 28, 2018
commit 7435bcb81fa6566950ce547c5841bb761ef4e10a
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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo: "possibility"

+ 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