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

Commit 6616439

Browse files
authored
Merge pull request #469 from json-schema-org/keyword-meta-schema
Add glossary entries for keyword and meta-schema.
2 parents 728086e + c5ecf1c commit 6616439

File tree

1 file changed

+19
-4
lines changed

1 file changed

+19
-4
lines changed

learn/glossary.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,30 @@ While future drafts may introduce new behavior or changes to existing behavior,
2424

2525
The current list of drafts can be found [here](https://json-schema.org/specification-links.html#published-drafts).
2626

27+
### keyword
28+
29+
A property appearing within a [schema](#schema) object.
30+
31+
The [JSON Schema specification](https://json-schema.org/specification.html) defines behavior for a large library of keywords which can be used to describe [instances](#instance).
32+
2733
### instance
2834

29-
A piece of JSON data which is to be validated by a [schema](#schema).
35+
A piece of JSON data which is to be described by a [schema](#schema).
3036

31-
JSON Schema can be used to validate JSON values of any type (as well as values from many JSON-like formats which can be reasonably represented as JSON).
37+
JSON Schema can be used to describe JSON values of any type (as well as values from many JSON-like formats which can be reasonably represented as JSON).
3238

3339
The JSON Schema specification makes no broad assumptions about the structure of instances themselves beyond those of the JSON specification itself.
3440
In particular it does not reserve any properties within a JSON object for its own use, or require parsers of JSON to support features beyond those already mandated of JSON implementations.
3541

42+
### meta-schema
43+
44+
A [schema](#schema) which is itself intended to describe other *schemas*.
45+
46+
JSON Schema defines a language for describing any [instance](#instance) using a schema written in JSON.
47+
Since schemas are themselves JSON values, they may be also be treated as *instances*, and therefore described by other schemas.
48+
49+
We refer to the schema-of-a-schema as a "meta-schema" to express this use.
50+
3651
### normative
3752

3853
In the context of JSON Schema, and formal specifications more broadly, a document which outlines standardized behavior.
@@ -48,9 +63,9 @@ This page for instance, not being a normative document, is not able to proscribe
4863

4964
### schema
5065

51-
A document, written according to the proscribed structure of the JSON Schema specification, which can be used to validate [instances](#instance).
66+
A document, written according to the proscribed structure of the JSON Schema specification, which can be used to describe [instances](#instance).
5267

53-
The rules constituting what schemas are *valid* JSON Schemas, as well as the rules governing their behavior when validating instances, are defined by the JSON Schema specification.
68+
The rules constituting which schemas are conformant, as well as the rules governing their behavior when validating instances, are defined by the [JSON Schema specification](https://json-schema.org/specification.html).
5469

5570
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.
5671

0 commit comments

Comments
 (0)