Skip to content

Commit ecf6c82

Browse files
committed
Improved wording for "id" property and specified that it resolves against parent schema
1 parent d3effee commit ecf6c82

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

draft-zyp-json-schema-03.xml

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -459,10 +459,14 @@ schemas are possible, but are not required. An example of using "extends":
459459
</section>
460460
<section title="id">
461461
<t>
462-
This attribute defines the URI of this schema (this attribute is effectively
463-
a "self" link). This URI MAY be relative or absolute. If the URI
464-
is relative, it SHOULD be resolved against the URI used to retrieve this schema.
465-
</t>
462+
This attribute defines the current URI of this schema (this attribute is
463+
effectively a "self" link). This URI MAY be relative or absolute. If
464+
the URI is relative it is resolved against the current URI of the parent
465+
schema it is contained in. If this schema is not contained in any
466+
parent schema, the current URI of the parent schema is held to be the
467+
URI under which this schema was addressed. If id is missing, the current URI of a schema is
468+
defined to be that of the parent schema. The current URI of the schema
469+
is also used to construct relative references such as for $ref.</t>
466470
</section>
467471
<section title="$ref">
468472
<t>
@@ -957,6 +961,7 @@ instead of numbers</t>
957961
<t>Added more explanation of nullability.</t>
958962
<t>Removed "alternate" attribute.</t>
959963
<t>Upper cased many normative usages of must, may, and should.</t>
964+
<t>Replaced the link submission "properties" attribute to "schema" attribute.</t>
960965
<t>Replaced "optional" attribute with "required" attribute.</t>
961966
<t>Replaced "maximumCanEqual" attribute with "exclusiveMaximum" attribute.</t>
962967
<t>Replaced "minimumCanEqual" attribute with "exclusiveMinimum" attribute.</t>

0 commit comments

Comments
 (0)