Skip to content

Commit ece27e6

Browse files
committed
Wording clarifications in general considerations.
These are the leftover bits of Issue #55 and some clarifications requested in a comment on issue #101 that have not already been added in some other PR for some other issue. These specific chagnes were previously approved in #143, but so many other things have changed since #143 that most of it was no longer relevant, so I closed it and started these changes over. In particular, explaining {} and {"not": {}} is no longer needed as they are covered while introducing "true" and "false" schemas in the core specification, so that is no longer repeated in this change. Likewise, the parent/child validation descriptions have been modified in several PRs and no longer has the problems that were previously a concern.
1 parent e1d31e8 commit ece27e6

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

jsonschema-validation.xml

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -184,21 +184,25 @@
184184
</t>
185185
</section>
186186

187-
<section title="Missing keywords">
187+
<section title="Constraints and missing keywords">
188+
<t>
189+
Each JSON Schema validation keyword adds constraints that
190+
an instance must satisfy in order to successfully validate.
191+
</t>
188192
<t>
189193
Validation keywords that are missing never restrict validation.
190194
In some cases, this no-op behavior is identical to a keyword that exists with certain values,
191195
and these values are noted where known.
192196
</t>
193197
</section>
194198

195-
<section title="Linearity">
196-
<!-- I call this "linear" in the same manner e.g. waves are linear, they don't interact with each other -->
199+
<section title="Keyword independence">
197200
<t>
198-
Validation keywords typically operate independent of each other, without affecting each other.
201+
Validation keywords typically operate independently, without
202+
affecting each other's outcomes.
199203
</t>
200204
<t>
201-
For author convenience, there are some exceptions:
205+
For schema author convenience, there are some exceptions:
202206
<list>
203207
<t>"additionalProperties", whose behavior is defined in terms of "properties" and "patternProperties";</t>
204208
<t>"additionalItems", whose behavior is defined in terms of "items"; and</t>

0 commit comments

Comments
 (0)