Skip to content

Commit d6e3a48

Browse files
committed
Loosen the verbiage around the schema<->instance interaction in the glossary.
1 parent a0c4a67 commit d6e3a48

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

learn/glossary.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ The [JSON Schema specification](https://json-schema.org/specification.html) defi
3232

3333
### instance
3434

35-
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).
3636

37-
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).
3838

3939
The JSON Schema specification makes no broad assumptions about the structure of instances themselves beyond those of the JSON specification itself.
4040
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.
@@ -63,9 +63,9 @@ This page for instance, not being a normative document, is not able to proscribe
6363

6464
### schema
6565

66-
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).
6767

68-
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).
6969

7070
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.
7171

0 commit comments

Comments
 (0)