Skip to content

Commit 28a8d1b

Browse files
committed
Further $vocabulary wording feedback.
1 parent c9abdcb commit 28a8d1b

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

jsonschema-core.xml

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -885,15 +885,19 @@
885885
</section>
886886
<section title='The "$vocabulary" Keyword'>
887887
<t>
888-
The "$vocabulary" keyword, which appears in a meta-schema, declares
888+
The "$vocabulary" keyword, which appears in a meta-schema, identifies
889889
what sets of keywords are expected to be used in schemas described
890890
by that meta-schema, and with what semantics. This is conceptually
891891
analogous to how most other keywords used in meta-schemas describe
892892
the syntax of keywords used in schemas described by that meta-schema.
893893
</t>
894894
<t>
895895
The value of this keyword MUST be an object. The property names in the
896-
object MUST be URIs, (containing a scheme) and this URI MUST be normalized.
896+
object MUST be URIs (containing a scheme) and this URI MUST be normalized.
897+
Each URI that appears as a property name identifies a specific set of
898+
keywords and their semantics.
899+
</t>
900+
<t>
897901
The URI MAY be a URL, but the nature of the retrievable resources is
898902
currently undefined, and reserved for future use. Vocabulary authors
899903
SHOULD NOT serve a document at that URL. A server MAY respond with
@@ -943,7 +947,8 @@
943947
behavior based on the meta-schema if it is recognized from the
944948
URI value of the referring schema's "$schema" keyword.
945949
If the meta-schema, as referenced by the schema, is not recognized,
946-
then implementations MAY assume the use of all vocabularies in this
950+
then implementations MUST assume the use of the core vocabulary,
951+
and SHOULD assume the use of all vocabularies in this
947952
specification and the companion Validation specification.
948953
</t>
949954
</section>
@@ -1876,6 +1881,10 @@
18761881
The current URI for the corresponding meta-schema is:
18771882
<eref target="https://json-schema.org/draft-08/applicator"/>.
18781883
</t>
1884+
<t>
1885+
Meta-schemas that do not use "$vocabulary" SHOULD be considered to
1886+
use this vocabulary as if its URI were present with a value of false.
1887+
</t>
18791888
<section title="Keyword Independence">
18801889
<t>
18811890
Schema keywords typically operate independently, without

0 commit comments

Comments
 (0)