Skip to content
This repository was archived by the owner on Nov 2, 2023. It is now read-only.

Commit 2f0f2ff

Browse files
committed
Add glossary entries for dialect and vocabulary.
1 parent d4659c1 commit 2f0f2ff

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

learn/glossary.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,15 @@ If you encounter a term you wish were defined here, please feel free to [file an
1414

1515
The entries on this page can be linked to via anchor links (e.g. `https://json-schema.org/learn/glossary.html#vocabulary`) when sharing a definition with others.
1616

17+
### dialect
18+
19+
A collection of [vocabularies](#vocabulary), along with an indication of whether supporting each vocabulary is required to process schemas written in the dialect.
20+
21+
Dialects are identified by a URI, which [schemas](#schema) may then reference in their `$schema` [keyword](#keyword).
22+
Doing so identifies the schema as being written in the dialect, and thereby indicates which keywords are usable within it, along with their intended meaning.
23+
24+
The JSON Schema specification [defines](https://json-schema.org/specification.html#general-purpose-meta-schema) a number of dialects, each of which enable vocabularies suitable for the dialect's specific use case.
25+
1726
### draft
1827

1928
An individual release of the JSON Schema specification.
@@ -70,3 +79,18 @@ The rules constituting which schemas are conformant, as well as the rules govern
7079
Strictly speaking, according to the specification, schemas are themselves JSON documents, though it is somewhat common for them to be authored or maintained in other languages which are easily translated to JSON, such as YAML.
7180

7281
In recent [drafts](#draft) of the specification, a schema is either a JSON object or a JSON boolean value.
82+
83+
### vocabulary
84+
85+
A collection of related [keywords](keyword), grouped to facilitate re-use.
86+
87+
A vocabulary typically includes both a [meta-schema](#meta-schema) which formally defines the keywords it contains, as well as a prose document or specification which explains the semantics of its keywords in a way suitable for implementers and users of the vocabulary.
88+
89+
Anyone can create and publish a vocabulary, and implementations generally will include facilities for extending themselves with support for additional vocabularies and their keywords.
90+
The JSON Schema specification includes a number of vocabularies which cover each of the keywords it defines.
91+
92+
Vocabularies are identified by a URI which may be referenced via the `$vocabulary` keyword in order to enable the vocabulary within a [dialect](#dialect).
93+
94+
#### See also
95+
96+
* [`json-schema-vocabularies`](https://github.com/json-schema-org/json-schema-vocabularies), a repository which collects known third-party JSON Schema vocabularies

0 commit comments

Comments
 (0)