diff --git a/jsonschema-core.xml b/jsonschema-core.xml
index 8233bee3..07b9436e 100644
--- a/jsonschema-core.xml
+++ b/jsonschema-core.xml
@@ -50,7 +50,7 @@
-
+
Internet Engineering Task Force
JSON
Schema
@@ -1824,10 +1824,10 @@
reference target, is preferable.
- An implementation MAY choose not to support addressing schemas
- by non-canonical URIs. As such, it is RECOMMENDED that schema authors only
- use canonical URIs, as using non-canonical URIs may reduce
- schema interoperability.
+ An implementation MAY choose not to support addressing schema resources
+ (and their subschemas) by non-canonical URIs.
+ As such, it is RECOMMENDED that schema authors only use canonical URIs,
+ as using non-canonical URIs may reduce schema interoperability.
This is to avoid requiring implementations to keep track of a whole
stack of possible base URIs and JSON Pointer fragments for each,
@@ -1836,6 +1836,11 @@
no point in forbidding it, while others have argued that it complicates
schema identification and should be forbidden. Feedback on this
topic is encouraged.
+ After some discussion, we feel that we need to remove the use of
+ "canonical" in favour of talking about JSON Pointers which reference
+ across schema resource boundaries as undefined or even forbidden behavior
+ (https://github.com/json-schema-org/json-schema-spec/issues/937,
+ https://github.com/json-schema-org/json-schema-spec/issues/1183)
@@ -3390,6 +3395,18 @@ https://example.com/schemas/common#/$defs/count/minimum
+
+ Note: The fragment part of the URI does not make it canonical or non-canonical,
+ rather, the base URI used (as part of the full URI with any fragment) is what
+ determines the canonical nature of the resulting full URI.
+
+ Multiple "canonical" URIs? We Acknowledge this is potentially confusing, and
+ direct you to read the CREF located in the
+ JSON Pointer fragments and embedded schema resources
+ section for futher comments.
+
+
+