Skip to content

Conversation

@afs
Copy link
Contributor

@afs afs commented Oct 23, 2025

This closes #223.
This closes #169 by referring to the irelative-iri production of the IRI grammar.

Add an informative section about minting IRIs, with defined terminology RDF Reference IRI for IRIs suitable for use in published RDF. The basic syntax of IRIs (RFC3986/7) is for other uses of IRIs and is too broad (e.g. http:abcd).

The section is "informative" because advice can not be checked or enforced when consuming published RDF. For example, the data consumer can not be assumed to know URI scheme rules.

Changes are in section 3.3.


Preview | Diff

@afs afs requested review from hartig and pchampin October 23, 2025 11:04
Copy link
Contributor

@Tpt Tpt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

resource regardless of where the IRI reference is used.
[[RFC3987]] defines a syntax that can express
IRIs which do not meet the requirement of being a global reference.
URI schemes add addition requirements; for example, the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
URI schemes add addition requirements; for example, the
URI schemes add additional requirements; for example, the

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
URI schemes add addition requirements; for example, the
Some URI schemes add additional requirements; for example, the

resource regardless of where the IRI reference is used.
[[RFC3987]] defines a syntax that can express
IRIs which do not meet the requirement of being a global reference.
URI schemes add addition requirements; for example, the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
URI schemes add addition requirements; for example, the
URI schemes add further requirements; for example, the

</p>
<p>
An <dfn data-lt="RDF reference">RDF Reference IRI</dfn>,
sometimes just <a>RDF Reference</a>,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
sometimes just <a>RDF Reference</a>,
sometimes just called<a>RDF Reference</a>,

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
sometimes just <a>RDF Reference</a>,
sometimes just called <a>RDF Reference</a>,

<section id="reference-iris" class="informative">
<h4>RDF Reference IRIs</h4>
<p>
This section is advice to data publishers.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This section is advice to data publishers.
This section provides advice to data publishers.

This section is advice to data publishers.
</p>
<p>
<a>IRIs</a> are used to denote <a>resources</a> and should identify the same
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a>IRIs</a> are used to denote <a>resources</a> and should identify the same
<a>IRIs</a> are used to denote <a>resources</a>, and each IRI should identify the same

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a>IRIs</a> are used to denote <a>resources</a> and should identify the same
<a>IRIs</a> are used to denote <a>resources</a>, and each IRI should always identify the same

</p>
<p>
<a>IRIs</a> are used to denote <a>resources</a> and should identify the same
resource regardless of where the IRI reference is used.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
resource regardless of where the IRI reference is used.
resource regardless of where that IRI is used.

<p>
<a>IRIs</a> are used to denote <a>resources</a> and should identify the same
resource regardless of where the IRI reference is used.
[[RFC3987]] defines a syntax that can express
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[[RFC3987]] defines a syntax that can express
Yet, the syntax for IRIs, as defined by [[RFC3987]], can express

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[[RFC3987]] defines a syntax that can express
Note that the general syntax for IRIs, defined by [[RFC3987]], can express

<a data-cite="rfc7230#http-URI">`http-URI`</a>, which
requires the presence of a non-empty host name, and, as a consequence,
the path component will start with `/`.
The [[RFC3987]] syntax permits `http:abcd` and `http:///abcd`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The [[RFC3987]] syntax permits `http:abcd` and `http:///abcd`
The [[RFC3987]] syntax permits IRI such as `http:abcd` and `http:///abcd`,

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The [[RFC3987]] syntax permits `http:abcd` and `http:///abcd`
The [[RFC3987]] syntax permits IRIs such as `http:abcd` and `http:///abcd`,

publishing location.
Relative IRI references must be
<dfn id="dfn-relative-iri" data-lt="relative iri reference">relative IRI references</dfn>
(production `irelative-ref` in the <a href="#iri-abnf">IRI Grammar</a>)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
(production `irelative-ref` in the <a href="#iri-abnf">IRI Grammar</a>)
(see the `irelative-ref` production in the <a href="#iri-abnf">IRI Grammar</a>)

Copy link
Contributor

@niklasl niklasl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! (Tiny correction in comment; @hartig's suggestions look good too.)

requires the presence of a non-empty host name, and, as a consequence,
the path component will start with `/`.
The [[RFC3987]] syntax permits `http:abcd` and `http:///abcd`
which do not meet the HTTP URI scheme.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
which do not meet the HTTP URI scheme.
but these are invalid, because they do not satisfy the HTTP URI scheme definition.

Comment on lines +1046 to +1053
<b>Reference Resolution:</b>
An <a>RDF Reference IRI</a> is unchanged by
<a data-cite="RFC3986#section-5">reference resolution</a>.
The <a data-cite="RFC3986#section-3.3">path component</a>
starts with a `/` character and does not contain `.` or `..` segments.
</p>
<p>
<strong>Relative IRI references:</strong>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems like Reference Resolution: should have the same semantic importance and styling as Relative IRI references:, so either both should be <b> or both should be <strong>. I think the latter is probably better, so that's my suggestion here.

Suggested change
<b>Reference Resolution:</b>
An <a>RDF Reference IRI</a> is unchanged by
<a data-cite="RFC3986#section-5">reference resolution</a>.
The <a data-cite="RFC3986#section-3.3">path component</a>
starts with a `/` character and does not contain `.` or `..` segments.
</p>
<p>
<strong>Relative IRI references:</strong>
<strong>Reference Resolution:</strong>
An <a>RDF Reference IRI</a> is unchanged by
<a data-cite="RFC3986#section-5">reference resolution</a>.
The <a data-cite="RFC3986#section-3.3">path component</a>
starts with a `/` character and does not contain `.` or `..` segments.
</p>
<p>
<strong>Relative IRI references:</strong>

Comment on lines +1058 to +1059
as a convenient shorthand that allows authoring of documents independently from their final
publishing location. Relative IRI references must be
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
as a convenient shorthand that allows authoring of documents independently from their final
publishing location. Relative IRI references must be
as a convenient shorthand that allows RDF documents to be authored without knowing
their final publishing location. Relative IRI references must be

Implementations are encouraged to follow the scheme-specific rules of
the common schemes, such as the
<a data-cite="RFC7230#section-2.7.1">scheme rules for HTTP/HTTPS</a> and the
<a data-cite="RFC7230#section-2.7">scheme rules for HTTP/HTTPS</a> and the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a data-cite="RFC7230#section-2.7">scheme rules for HTTP/HTTPS</a> and the
scheme rules for <a data-cite="RFC7230#section-2.7">HTTP/HTTPS</a> and the

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

RDF Reference IRI Relative IRI Reference should bind to the irelative-ref production

7 participants