From c5acd683acd7fc4d62f4090ce2765131fb9f57f0 Mon Sep 17 00:00:00 2001
From: "Henry H. Andrews" <andrews_henry@yahoo.com>
Date: Wed, 18 Jan 2023 10:39:47 -0800
Subject: [PATCH] MUST use opt vocab & treat unknowns as annotations

This strengthens two SHOULDs to MUSTS:

* Implementations MUST proceed with processing schemas using
  unrecognized optional vocabularies
* Implementations MUST collect unknown keywords as annotations
  if such collection is supported and not disabled
---
 jsonschema-core.xml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/jsonschema-core.xml b/jsonschema-core.xml
index 38d71473..0067ee26 100644
--- a/jsonschema-core.xml
+++ b/jsonschema-core.xml
@@ -620,8 +620,9 @@
 
                 <section title="Handling of unrecognized or unsupported keywords" anchor="unrecognized">
                     <t>
-                        Implementations SHOULD treat keywords they do not recognize, or that
-                        they recognize but do not support, as annotations, where the value of
+                        If annotation collection is supported and not disabled, implementations
+                        MUST treat keywords they do not recognize, or that they recognize but
+                        do not support, as annotations, where the collected value of
                         the keyword is the value of the annotation.  Whether an implementation
                         collects these annotations or not, they MUST otherwise ignore the keywords.
                     </t>
@@ -1298,7 +1299,7 @@
                         </t>
                         <t>
                             Implementations that do not support a vocabulary that is optionally used
-                            by a schema SHOULD proceed with processing the schema.  The keywords will
+                            by a schema MUST proceed with processing the schema.  The keywords will
                             be considered to be unrecognized keywords as addressed by
                             <xref target="unrecognized"></xref>.  Note that since
                             the recommended behavior for such keywords is to collect them as