Skip to content

Commit 4f9e4e3

Browse files
committed
Split "Metadata" in to re-use + annotations
In preparation for the applicability text, split out "definitions" into its own section about re-use, and rename the remainder of the old metadata section to focus on annotation of schemas with keywords or new vocabularies. Rework the "definitoins" section text, but leave the other sections alone until the next commit.
1 parent dd0b873 commit 4f9e4e3

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

jsonschema-validation.xml

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1100,25 +1100,23 @@
11001100

11011101
</section>
11021102

1103-
<section title="Metadata keywords">
1104-
<section title="definitions">
1105-
<t>
1106-
This keyword's value MUST be an object.
1107-
Each member value of this object MUST be a valid JSON Schema.
1108-
</t>
1109-
<t>
1110-
This keyword plays no role in validation per se. Its role is to provide
1111-
a standardized location for schema authors to inline JSON Schemas into a
1112-
more general schema.
1113-
</t>
1114-
1115-
<t>
1116-
As an example, here is a schema describing an array of positive
1117-
integers, where the positive integer constraint is a subschema in
1118-
"definitions":
1103+
<section title='Schema re-use with "definitions"'>
1104+
<t>
1105+
The "definitions" keywords provides a standardized location for schema
1106+
authors to inline re-usable JSON Schemas into a more general schema.
1107+
The keyword does not directly affect the validation result.
1108+
</t>
1109+
<t>
1110+
This keyword's value MUST be an object.
1111+
Each member value of this object MUST be a valid JSON Schema.
1112+
</t>
1113+
<t>
1114+
As an example, here is a schema describing an array of positive
1115+
integers, where the positive integer constraint is a subschema in
1116+
"definitions":
11191117

1120-
<figure>
1121-
<artwork>
1118+
<figure>
1119+
<artwork>
11221120
<![CDATA[
11231121
{
11241122
"type": "array",
@@ -1131,10 +1129,12 @@
11311129
}
11321130
}
11331131
]]>
1134-
</artwork>
1135-
</figure>
1136-
</t>
1137-
</section>
1132+
</artwork>
1133+
</figure>
1134+
</t>
1135+
</section>
1136+
1137+
<section title="Schema annotations and extension vocabularies">
11381138

11391139
<section title='"title" and "description"'>
11401140
<t>

0 commit comments

Comments
 (0)