Skip to content

Suggestions from January review on §1.4 #194

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Suggestions from January review on §1.4 #194

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
4ec218a
concrete syntax allow to *associate* prefixes with IRIs
pchampin Apr 14, 2025
30e15d4
pnames actually satisfy the IRI grammar
pchampin Apr 23, 2025
cf070ef
improve working around namespace table
pchampin Apr 23, 2025
f895a78
add missing verb, and follow @hartig's proposal
pchampin Apr 24, 2025
851d2c1
Apply suggestions from code review
pchampin Apr 25, 2025
6d11414
clarify text
pchampin Apr 25, 2025
5f5790b
Update spec/index.html
pchampin Apr 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions spec/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -269,10 +269,11 @@ <h3>RDF Vocabularies and Namespace IRIs</h3>
<p>The <a>IRIs</a> in an <a>RDF vocabulary</a> often begin with
a common substring known as a <dfn>namespace IRI</dfn>.
Some namespace IRIs are associated by convention with a short name
known as a <dfn>namespace prefix</dfn>. Some examples:
known as a <dfn>namespace prefix</dfn>.
The table below provides some examples.

<table id="tab-vocab-ns" class="simple">
<caption>Some example namespace prefixes and IRIs</caption>
<caption>Some namespace prefixes and IRIs used in this specification</caption>
<tr>
<th>Namespace prefix</th>
<th>Namespace IRI</th>
Expand All @@ -293,16 +294,19 @@ <h3>RDF Vocabularies and Namespace IRIs</h3>
</tr>
</table>

<p>In some serialization formats it is common to abbreviate <a>IRIs</a>
that start with <a>namespace IRIs</a> by using a
<a>namespace prefix</a> in order to assist readability. For example, the IRI
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral</code>
<p>In some serialization formats, it is common
to associate some [=namespace IRIs=] with arbitrary [=namespace prefixes=],
and to improve readability by abbreviating <a>IRIs</a> that start with one of those <a>namespace IRIs</a>
by using the corresponding <a>namespace prefix</a>.
For example,
based on the prefix mapping in <a href="#tab-vocab-ns"></a>,
the IRI <code>http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral</code>
would be abbreviated as <code>rdf:XMLLiteral</code>.
Note however that these abbreviations are <em>not</em> valid IRIs,
and must not be used in contexts where IRIs are expected.
Note, however, that these "prefixed name" abbreviations are generally <em>not</em> valid IRIs,
Copy link
Contributor

Choose a reason for hiding this comment

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

Prefixed names are not IRIs. They could be "expanded to give IRIs during parsing".

Suggested change
Note, however, that these "prefixed name" abbreviations are generally <em>not</em> valid IRIs,
Note, however, that these "prefixed name" abbreviations are <em>not</em> valid IRIs,

I am not sure what the "valid" means here.

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
Note, however, that these "prefixed name" abbreviations are generally <em>not</em> valid IRIs,
Note, however, that these "prefixed name" abbreviations are generally <em>not</em> IRIs,

and must not be used in contexts where only non-prefixed IRIs are expected.
Copy link
Contributor

Choose a reason for hiding this comment

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

such as? Is this hinting at RDF/XML and qnames?

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
and must not be used in contexts where only non-prefixed IRIs are expected.
and must not be used in contexts where only IRIs are expected.

Namespace IRIs and namespace prefixes are <em>not</em> a formal part of the
RDF data model. They are merely a syntactic convenience for
abbreviating IRIs.</p>
RDF data model. They are merely a convenience for
abbreviating IRIs in some syntaxes.</p>

<p>The term “<dfn class="lint-ignore">namespace</dfn>” on its own does not have a
well-defined meaning in the context of RDF, but is sometimes informally
Expand Down
Loading