diff --git a/jsonschema-core.xml b/jsonschema-core.xml
index 25b0e605..3f99e8e8 100644
--- a/jsonschema-core.xml
+++ b/jsonschema-core.xml
@@ -1587,7 +1587,14 @@
- The "$ref" keyword is used to reference a statically identified schema.
+ The "$ref" keyword is an applicator that is used to reference a statically
+ identified schema. Its results are the results of the referenced schema.
+
+ Note that this definition of how the results are determined means that
+ other keywords can appear alongside of "$ref" in the same schema object.
+
+
+
The value of the "$ref" property MUST be a string which is a URI-Reference.
Resolved against the current URI base, it produces the URI of the schema
to apply.
@@ -1653,6 +1660,10 @@
when it is present), "$recursiveRef"'s behavior is identical to
that of "$ref".
+
+ As with "$ref", the results of this keyword are the results of the
+ referenced schema.
+