diff --git a/pages/learn/glossary.md b/pages/learn/glossary.md index 66b4a3abc..decf97dbf 100644 --- a/pages/learn/glossary.md +++ b/pages/learn/glossary.md @@ -53,6 +53,10 @@ A property appearing within a [schema](#schema) object. The [JSON Schema specification](../specification) defines behavior for a large library of keywords which can be used to describe [instances](#instance). +### implementation + +Historically, the word "implementation" has been used to describe both specifically validators/annotators (the scope of the spec) and also various other kinds of JSON Schema tooling. However, due to this ambiguity, we have decided that the preferred conversational term should be ["tooling"](#tooling). + ### instance A piece of JSON data which is to be described by a [schema](#schema). @@ -112,6 +116,19 @@ Said more plainly, whether a particular value is a subschema or not depends on i Subschemas may themselves contain sub-subschemas, though colloquially one generally uses the term "subschema" regardless of the level of nesting, further clarifying which larger schema is the parent schema whenever needed. +### tooling + +A JSON Schema tool (or colloquially "tooling") is any software application or library for working with or evaluating schemas in some way. + +The following are considered tools: + +- a validator library +- a CLI validator +- a schema or code generator +- a UI form generator + +Applications which use JSON Schema internally without exposing that functionality in some way, for example, validating configuration files or web requests, are not considered tooling. + ### vocabulary A tightly related collection of [keywords](#keyword), grouped to facilitate re-use.