Skip to content

Commit fcf9261

Browse files
committed
Add a note on URLs and URNs in 3.2.
1 parent 210cbc6 commit fcf9261

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

index.html

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -980,14 +980,22 @@ <h2>IRIs</h2>
980980
In JSON-LD, with exceptions are as described below, all <a>relative IRIs</a>
981981
are resolved relative to the <a>base IRI</a>.</p>
982982

983+
<p class="note">As noted in <a href="#how-to-read-this-document" class="sectionRef"></a>,
984+
IRIs can often be confused with URLs (<a data-cite="ld-glossary#uniform-resource-locator">Uniform Resource Locators</a>),
985+
the primary distinction is that a URL <em>locates</em> a resource on the web,
986+
an IRI <em>identifies</em> a resource. While it is a good practice for resource identifiers
987+
to be dereferencable, sometimes this is not practical. In particular, note the
988+
[[URN]] scheme for Uniform Resource Names, such as <a data-cite="rfc4122">UUID</a>.
989+
An example UUID is <code>urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6</code>.</p>
990+
983991
<p class="note"><a>Properties</a>, values of <code>@type</code>,
984992
and values of <a>properties</a> with a <a>term definition</a>
985993
that defines them as being relative to the <a>vocabulary mapping</a>,
986994
may have the form of a <a>relative IRI</a>, but are resolved using the
987995
<a>vocabulary mapping</a>, and not the <a>base IRI</a>.</p>
988996

989997
<p>A <a>string</a> is interpreted as an <a>IRI</a> when it is the
990-
value of an <a>dictionary member</a> with the key<code>@id</code>:</p>
998+
value of an <a>dictionary member</a> with the key <code>@id</code>:</p>
991999

9921000
<pre class="example nohighlight" data-transform="updateExample"
9931001
title="Values of @id are interpreted as IRI">

0 commit comments

Comments
 (0)