diff --git a/jsonschema-core.xml b/jsonschema-core.xml index 95fe91c4..b8b9aca7 100644 --- a/jsonschema-core.xml +++ b/jsonschema-core.xml @@ -103,7 +103,8 @@ This specification defines JSON Schema core terminology and mechanisms, including pointing to another JSON Schema by reference, dereferencing a JSON Schema reference, - specifying the vocabulary being used, + specifying the dialect being used, + specifying a dialect's vocabulary requirements, and defining the expected output. @@ -146,9 +147,10 @@ some sort of condition. - To facilitate re-use, keywords can be organized into vocabularies. A vocabulary + To facilitate re-use, keywords can be organized into vocabularies. A vocabulary consists of a list of keywords, together with their syntax and semantics. - A set of vocabularies identified by a meta-schema is known as a dialect. + A dialect is defined as a set of vocabularies and their required support + identified in a meta-schema. JSON Schema can be extended either by defining additional vocabularies, @@ -1198,7 +1200,8 @@ vocabularies available for use in schemas described by that meta-schema. It is also used to indicate whether each vocabulary is required or optional, in the sense that an implementation MUST understand the required vocabularies - in order to successfully process the schema. + in order to successfully process the schema. Together, this information forms + a dialect. The value of this keyword MUST be an object. The property names in the