Skip to content

Commit b12297b

Browse files
committed
Address IETF review comments
#9 #8 #7
1 parent 0af15d8 commit b12297b

File tree

1 file changed

+50
-8
lines changed

1 file changed

+50
-8
lines changed

draft-lemieux-doi-uri-scheme-05.xml renamed to draft-lemieux-doi-uri-scheme-06.xml

Lines changed: 50 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@
1010

1111
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="independent"
1212
category="info" ipr="trust200902" xml:lang="en" version="3"
13-
docName="draft-lemieux-doi-uri-scheme-05" >
13+
docName="draft-lemieux-doi-uri-scheme-06" >
1414
<front>
1515
<title>The "doi" URI Scheme</title>
1616

17-
<seriesInfo name="Internet-Draft" value="draft-lemieux-doi-uri-scheme-05"
17+
<seriesInfo name="Internet-Draft" value="draft-lemieux-doi-uri-scheme-06"
1818
status="informational"/>
1919

2020
<author initials='P.-A.' surname='Lemieux' fullname='Pierre-Anthony Lemieux' role="editor">
@@ -85,8 +85,9 @@ docName="draft-lemieux-doi-uri-scheme-05" >
8585
<t>As specified at <xref target="iso26324"/>, a DOI name consists of an
8686
ordered sequence of Unicode code points of the Graphic type.</t>
8787

88-
<t>The <tt>scheme-specific-part</tt> of the URI corresponding to a given
89-
DOI name, i.e., the DOI Name URI, SHALL be equal to the result of the
88+
<t>A DOI Name URI is a URI that corresponds to a given DOI name. As
89+
defined at <xref target="RFC7595"/>, its scheme name SHALL be "doi" and
90+
its <tt>scheme-specific-part</tt> SHALL be equal to the result of the
9091
following ordered sequence of steps:</t>
9192

9293
<ol>
@@ -97,7 +98,7 @@ docName="draft-lemieux-doi-uri-scheme-05" >
9798
<tt>unreserved</tt> nor equal to <tt>"/"</tt>.</li>
9899
</ol>
99100

100-
<t>The URI shall contain neither a query component nor a fragment
101+
<t>A DOI Name URI shall contain neither a query component nor a fragment
101102
component.</t>
102103

103104
<t>EXAMPLE 1: The DOI name "10.5594/SMPTE.ST2067-21.2020" corresponds to
@@ -125,9 +126,24 @@ docName="draft-lemieux-doi-uri-scheme-05" >
125126
the code point U+00E1 or the sequence of code points &lt;U+0061,
126127
U+0301&gt;. Presenting a DOI name in its URI form resolves this
127128
ambiguity.</t>
129+
</section>
130+
131+
<section anchor="sec-doi-name-equivalence">
132+
<name>Equivalence</name>
133+
134+
<t>The following procedure SHALL be performed to determine whether two DOI
135+
Name URIs are equivalent:</t>
136+
137+
<ol>
138+
<li>the <tt>scheme-specific-part</tt> of each of the two URIs is
139+
percent-decoded into a UTF-8 String;</li>
140+
<li>the two UTF-8 Strings are interpreted as two DOI names;</li>
141+
<li>the two DOI Name URIs are equivalent if the two DOI names are
142+
equivalent, as defined at <xref target="DOI-RP"/>.</li>
143+
</ol>
128144

129-
<t>NOTE 3: DOI names are case-insensitive only when testing for
130-
equivalence and only with respect to the Basic Latin Unicode block.</t>
145+
<t>NOTE: When testing for equivalence, DOI names are case-insensitive only
146+
with respect to the Basic Latin Unicode block.</t>
131147
</section>
132148

133149
<section anchor="sec-doi-name-resolution">
@@ -226,12 +242,38 @@ docName="draft-lemieux-doi-uri-scheme-05" >
226242

227243
</section>
228244

245+
<section anchor="sec-doi-uri-dereferencing">
246+
<name>Retrieving the referent identified by a DOI name</name>
247+
248+
<t>While <xref target="sec-doi-name-resolution"/> specifies the procedure
249+
for retrieving the DOI record associated with DOI name, the steps
250+
necessary to retrieve the actual referent described by the record depends
251+
on the nature of the referent, e.g., a referent can be a physical
252+
object.</t>
253+
254+
<t>Some, but not all, referents can be retrieved by dereferencing an
255+
HTTP/HTTPS URI found in their respective DOI records, as illustrated in
256+
<xref target="fig-sample-response"/> where the referent identified by the
257+
DOI name "10.1000/182" can be retrieved at "http://www.doi.org/hb.html".</t>
258+
259+
<t>The <em>single DOI resolution</em> and <em>multiple doi resolution</em>
260+
functions at <xref target="DOI-RP"/> specify the process of retrieving a
261+
referent that is available by dereferencing an HTTP/HTTPS URI.</t>
262+
</section>
263+
229264
<section>
230265
<name>Security Considerations</name>
231266
<t>A DOI name is an opaque string, which does not have a discernible
232267
meaning on its own and is for use by humans and machines alike. It
233268
consists of a sequence of Unicode codepoints and the security
234-
considerations at <xref target="UNICODE-TR36"/> apply.</t>
269+
considerations at <xref target="UNICODE-TR36"/> apply. In particular, and
270+
as noted at <xref target="doi-name-syntax"/>, presenting a DOI name by
271+
rendering its sequence of code points to glyphs can be ambiguous. As a
272+
result, two DOI names rendering to the same sequence of glyphs can
273+
identify referents, including, for example, two software executables with
274+
wildly different side-effects. Presenting a DOI name in its URI form,
275+
which consists of a limited subset of characters, can lessen this
276+
risk.</t>
235277

236278
<t>The DOI name resolution process is conducted using the Hypertext
237279
Transfer Protocol Secure, which ensures condifentiality and integrity of

0 commit comments

Comments
 (0)