From ced9c21a9d30432b5588cbd4a9e316d62348ba76 Mon Sep 17 00:00:00 2001 From: Greg Dennis Date: Sat, 26 Apr 2025 21:04:02 +1200 Subject: [PATCH 1/2] clarify the relationship between resources and docs; clarify that external docs should specify their usage of json schema --- specs/jsonschema-core.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/specs/jsonschema-core.md b/specs/jsonschema-core.md index 3154ae5e..80110bc5 100644 --- a/specs/jsonschema-core.md +++ b/specs/jsonschema-core.md @@ -252,13 +252,13 @@ is identical to the primary resource. This can occur with the empty fragment, or when one schema resource is embedded in another. Any such IRIs with fragments are considered to be non-canonical. -The root schema is the schema that comprises the entire JSON document in -question. The root schema is always a schema resource, where the IRI is -determined as described in {{initial-base}}.[^1] +A root schema, which may comprise the entire JSON document, is the top-level +schema that is identified by the absolute IRI. The root schema is always a +schema resource, where the IRI is determined as described in {{initial-base}}. -[^1]: Note that documents that embed schemas in another format will not have a -root schema resource in this sense. Exactly how such usages fit with the JSON -Schema document and resource concepts will be clarified in a future draft. +Documents formats which embed JSON Schemas within them will not necessarily have +a single root schema in this sense. How root schemas are identified within such +documents SHOULD be defined by the specifications which govern them. Some keywords take schemas themselves, allowing JSON Schemas to be nested: From 3445c0dea29e0779b8156c82ad3378525b6609e6 Mon Sep 17 00:00:00 2001 From: Greg Dennis Date: Sun, 27 Apr 2025 07:20:07 +1200 Subject: [PATCH 2/2] Update specs/jsonschema-core.md Co-authored-by: Karen Etheridge --- specs/jsonschema-core.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specs/jsonschema-core.md b/specs/jsonschema-core.md index 80110bc5..5a578e41 100644 --- a/specs/jsonschema-core.md +++ b/specs/jsonschema-core.md @@ -256,7 +256,7 @@ A root schema, which may comprise the entire JSON document, is the top-level schema that is identified by the absolute IRI. The root schema is always a schema resource, where the IRI is determined as described in {{initial-base}}. -Documents formats which embed JSON Schemas within them will not necessarily have +Document formats which embed JSON Schemas within them will not necessarily have a single root schema in this sense. How root schemas are identified within such documents SHOULD be defined by the specifications which govern them.