Skip to content

Commit 9cbb385

Browse files
committed
add guidance for schema authors about locatable IRIs
1 parent 7ad5074 commit 9cbb385

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

jsonschema-core.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1045,7 +1045,10 @@ IRI.
10451045

10461046
Note that this IRI is an identifier and not necessarily a network locator. In
10471047
the case of a network-addressable URL, a schema need not be downloadable from
1048-
its canonical IRI.
1048+
its canonical IRI. However, schema authors SHOULD refrain from creating schemas
1049+
that use a locatable `$id` value unless the schema will be available at the
1050+
indicated location. Otherwise, an IRI which does not convey location semantics
1051+
SHOULD be used.
10491052

10501053
If present, the value for this keyword MUST be a string, and MUST represent a
10511054
valid [IRI-reference](#rfc3987). This IRI-reference SHOULD be normalized, and

0 commit comments

Comments
 (0)