Skip to content

Commit d59a563

Browse files
committed
add section on explicit annotations; disallow unknown keywords
1 parent ab0453e commit d59a563

File tree

1 file changed

+14
-4
lines changed

1 file changed

+14
-4
lines changed

jsonschema-core.xml

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -624,12 +624,22 @@
624624
for registering and implementing such handlers is implementation-dependent.
625625
</t>
626626

627+
<section title="Explicit annotation keywords" anchor="explicit-annotation">
628+
<t>
629+
The values of keywords which begin with the "@" symbol MUST be
630+
collected as annotations.
631+
</t>
632+
<t>
633+
Consequently, the "@" symbol is reserved for this purpose, and
634+
extension vocabularies which define keywords that start with "@"
635+
MUST define them as annotation-only keywords.
636+
</t>
637+
</section>
638+
627639
<section title="Handling of unrecognized or unsupported keywords" anchor="unrecognized">
628640
<t>
629-
Implementations SHOULD treat keywords they do not recognize, or that
630-
they recognize but do not support, as annotations, where the value of
631-
the keyword is the value of the annotation. Whether an implementation
632-
collects these annotations or not, they MUST otherwise ignore the keywords.
641+
Implementations MUST refuse to process schemas which contain
642+
unrecognized or unsupported keywords.
633643
</t>
634644
</section>
635645
</section>

0 commit comments

Comments
 (0)