Skip to content

Commit 646116e

Browse files
committed
Review feedback on vocabs.
1 parent 7809038 commit 646116e

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

jsonschema-core.xml

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -369,13 +369,16 @@
369369
<t>
370370
A schema vocabulary, or simply a vocabulary, is a set of keywords,
371371
their syntax, and their semantics. A vocabulary is generally organized
372-
around a particular purpose. Different uses of JSON Schema will
372+
around a particular purpose. Different uses of JSON Schema, such
373+
as validation, hypermedia, or user interface generation, will
373374
involve different sets of vocabularies.
374375
</t>
375376
<t>
376377
Vocabularies are the primary unit of re-use in JSON Schema, as schema
377378
authors can indicate what vocabularies are required or optional in
378-
order to process the schema. While keywords can be supported outside
379+
order to process the schema. Since vocabularies are identified by URIs
380+
in the meta-schema, generic implementations can load extensions to support
381+
previously unkonw vocabularies. While keywords can be supported outside
379382
of any vocabulary, there is no analogous mechanism to indicate individual
380383
keyword usage.
381384
</t>
@@ -798,7 +801,7 @@
798801
<section title="Meta-Schemas and Vocabularies" anchor="vocabulary">
799802
<t>
800803
Two concepts, meta-schemas and vocabularies, are used to inform an implementation
801-
how to interpret a schema. Every schema has a meta-schema, typically identified
804+
how to interpret a schema. Every schema has a meta-schema, which can be declared
802805
using the "$schema" keyword.
803806
</t>
804807
<t>
@@ -824,7 +827,8 @@
824827
vocabularies to be combined in different ways, and for meta-schema authors
825828
to impose additional constraints such as forbidding certain keywords, or
826829
performing unusually strict syntactical validation, as might be done
827-
during a development and testing cycle.
830+
during a development and testing cycle. Each vocabulary typically identifies
831+
a meta-schema consisting only of the vocabulary's keywords.
828832
</t>
829833
<t>
830834
Meta-schema authoring is an advanced usage of JSON Schema, so the design of

0 commit comments

Comments
 (0)