- 
                Notifications
    You must be signed in to change notification settings 
- Fork 9
RDF Reference IRI #255
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.
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
base: main
Are you sure you want to change the base?
RDF Reference IRI #255
Conversation
There was a problem hiding this 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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| URI schemes add addition requirements; for example, the | |
| URI schemes add additional requirements; for example, the | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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>, | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| sometimes just <a>RDF Reference</a>, | |
| sometimes just called<a>RDF Reference</a>, | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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. | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| <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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| <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. | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [[RFC3987]] defines a syntax that can express | |
| Yet, the syntax for IRIs, as defined by [[RFC3987]], can express | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [[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` | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| The [[RFC3987]] syntax permits `http:abcd` and `http:///abcd` | |
| The [[RFC3987]] syntax permits IRI such as `http:abcd` and `http:///abcd`, | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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>) | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| (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>) | 
There was a problem hiding this 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. | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| which do not meet the HTTP URI scheme. | |
| but these are invalid, because they do not satisfy the HTTP URI scheme definition. | 
| <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> | 
There was a problem hiding this comment.
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.
| <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> | 
| as a convenient shorthand that allows authoring of documents independently from their final | ||
| publishing location. Relative IRI references must be | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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 | 
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| <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 | 
This closes #223.
This closes #169 by referring to the
irelative-iriproduction of the IRI grammar.Add an informative section about minting IRIs, with defined terminology
RDF Reference IRIfor 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