diff --git a/jsonschema-core.xml b/jsonschema-core.xml index aa478ec5..b00a32db 100644 --- a/jsonschema-core.xml +++ b/jsonschema-core.xml @@ -301,11 +301,17 @@ written for this particular version. - The root schema of a JSON Schema document SHOULD use this keyword. The value of this keyword MUST be a URI (containing a scheme) and this URI MUST be normalized. The current schema MUST be valid against the meta-schema identified by this URI. + + The "$schema" keyword SHOULD be used in a root schema. + It MUST NOT appear in subschemas. + + + While this pattern is likely to remain best practice for schema authoring, implementation behavior is subject to be revised or liberalized in future drafts. + Values for this property are defined in other documents and by other parties. JSON Schema implementations SHOULD implement support for current and previous published drafts