diff --git a/jsonschema-core.xml b/jsonschema-core.xml index 6288e746..df45d05e 100644 --- a/jsonschema-core.xml +++ b/jsonschema-core.xml @@ -146,6 +146,7 @@ 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. JSON Schema can be extended either by defining additional vocabularies, @@ -173,7 +174,9 @@ Further vocabularies for purposes such as structural validation or - hypermedia annotation are defined in other documents. + hypermedia annotation are defined in other documents. These other + documents each define a dialect collecting the standard sets of + vocabularies needed to write schemas for that document's purpose. diff --git a/jsonschema-validation.xml b/jsonschema-validation.xml index 722c502c..a8026d89 100644 --- a/jsonschema-validation.xml +++ b/jsonschema-validation.xml @@ -177,9 +177,10 @@
- The current URI for the default JSON Schema meta-schema is + The current URI for the default JSON Schema dialect meta-schema is . - For schema author convenience, this meta-schema describes all vocabularies + For schema author convenience, this meta-schema describes a dialect + consisting of all vocabularies defined in this specification and the JSON Schema Core specification, as well as two former keywords which are reserved for a transitional period. Individual vocabulary and vocabulary meta-schema URIs are given for