You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 2, 2023. It is now read-only.
Copy file name to clipboardExpand all lines: learn/glossary.md
+19-4Lines changed: 19 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -24,15 +24,30 @@ While future drafts may introduce new behavior or changes to existing behavior,
24
24
25
25
The current list of drafts can be found [here](https://json-schema.org/specification-links.html#published-drafts).
26
26
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
+
27
33
### instance
28
34
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).
30
36
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).
32
38
33
39
The JSON Schema specification makes no broad assumptions about the structure of instances themselves beyond those of the JSON specification itself.
34
40
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.
35
41
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
+
36
51
### normative
37
52
38
53
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
48
63
49
64
### schema
50
65
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).
52
67
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).
54
69
55
70
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.
0 commit comments