From 9d4c9b01cc1c39edc1ed73b56d615408998b9592 Mon Sep 17 00:00:00 2001 From: Greg Dennis Date: Tue, 11 Jun 2024 13:25:08 +1200 Subject: [PATCH] update wording to more effectively convey that these keywords are 'known' --- jsonschema-core.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/jsonschema-core.md b/jsonschema-core.md index 8f184591..616407fb 100644 --- a/jsonschema-core.md +++ b/jsonschema-core.md @@ -424,11 +424,13 @@ Implementations MAY provide the ability to register or load handlers for vocabularies that they do not support directly. The exact mechanism for registering and implementing such handlers is implementation-dependent. -#### Explicit annotation keywords {#explicit-annotations} +#### Implicit annotation keywords {#implicit-annotations} -The values of keywords which begin with "x-" MUST be collected as annotations. +Keywords which begin with "x-" are implicitly defined as annotation keywords. -Keywords which begin with "x-" symbol MUST NOT affect evaluation of a schema in +The values of such keywords MUST be collected as annotations. + +Implicit annotation keywords MUST NOT affect evaluation of a schema in any way other than annotation collection. Consequently, the "x-" prefix is reserved for this purpose, and extension