Skip to content

Commit 066204c

Browse files
committed
Update "dependencies" CREF
We're no longer likely to drop it, but we are likely to split it. This was successful in provoking feedback before so let's keep it up to date.
1 parent 539187b commit 066204c

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

jsonschema-validation.xml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -686,14 +686,14 @@
686686
<section title="dependencies">
687687
<t>
688688
<cref>
689-
Now that "if", "then", and "else" are keywords, it is not clear whether
690-
there is any benefit in keeping the schema form of "dependencies".
691-
It is frequently misunderstood, and having a form that takes a subschema
692-
as well as a form that takes a primitive value is particularly
693-
confusing. And it seems to be rarely used. Depending on feedback
694-
with "if", "then", and "else", the schema form of this keyword may
695-
well be removed in a future draft. Current thought is that the string
696-
form (giving property names in an array) is a useful shortcut.
689+
This keyword may be split into two, with the variation that uses
690+
an array of property names rather than a subschema getting a new
691+
name. The dual behavior is confusing and relatively difficult to
692+
implement. In the previous draft, we proposed dropping the keyword
693+
altogether, or dropping one of its forms, but we received feedback
694+
in support of keeping it. See issues #442 and #528 at
695+
&lt;https://github.com/json-schema-org/json-schema-spec/issues&gt;
696+
for further discussion. Further feedback is encouraged.
697697
</cref>
698698
</t>
699699
<t>

0 commit comments

Comments
 (0)