From 37f634c3579553fcd58294d7cf4135b2c4732034 Mon Sep 17 00:00:00 2001
From: Henry Andrews <henry@cloudflare.com>
Date: Fri, 1 Sep 2017 14:39:39 -0700
Subject: [PATCH] Highlight the challenges of extending meta-schemas

This addresses the original question posed in #86, which
noted that simply saying that meta-schemas can be extended
with "allOf" is misleading and likely to lead to errors.
---
 jsonschema-core.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/jsonschema-core.xml b/jsonschema-core.xml
index b58771e7..13efa853 100644
--- a/jsonschema-core.xml
+++ b/jsonschema-core.xml
@@ -356,6 +356,11 @@
                     This extended meta-schema SHOULD be referenced using the "$schema" keyword, to
                     allow tools to follow the correct behaviour.
                 </t>
+                <t>
+                    Note that the recursive nature of meta-schemas requires re-definining
+                    recursive keywords in the extended meta-schema, as can be seen in
+                    the JSON Hyper-Schema meta-schema.
+                </t>
             </section>
 
         </section>