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