Skip to content

Commit d078e30

Browse files
committed
add guidance for schema authors about locatable IRIs
1 parent de65b76 commit d078e30

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
@@ -1058,7 +1058,10 @@ IRI.
10581058

10591059
Note that this IRI is an identifier and not necessarily a network locator. In
10601060
the case of a network-addressable URL, a schema need not be downloadable from
1061-
its canonical IRI.
1061+
its canonical IRI. However, schema authors SHOULD refrain from creating schemas
1062+
that use a locatable `$id` value unless the schema will be available at the
1063+
indicated location. Otherwise, an IRI which does not convey location semantics
1064+
SHOULD be used.
10621065

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

0 commit comments

Comments
 (0)