Skip to content

Commit ae03ee1

Browse files
authored
Fix links to "phase" (#158)
This corrects several links to "phase", which were pointing to the wrong concept, and links several unlinked uses of the word.
1 parent fa02761 commit ae03ee1

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

index.html

+26-26
Original file line numberDiff line numberDiff line change
@@ -324,19 +324,19 @@ <h2>Network requests</h2>
324324
</ol>
325325

326326
<p>
327-
The only mandatory phase is the <a>transmission of request and
328-
response</a>; the other phases might not be needed for every <a>network
329-
request</a>. For instance, DNS results can be cached locally in the
330-
user agent, eliminating <a>DNS resolution</a> for future requests to the
331-
same domain. Similarly, HTTP <a>persistent connections</a> allow open
332-
connections to be shared for multiple requests to the same <a>origin</a>.
333-
However, if multiple <a>phases</a> occur, they will occur in the above
334-
order.
327+
The only mandatory <a>phase</a> is the <a>transmission of request and
328+
response</a>; the other <a>phases</a> might not be needed for every
329+
<a>network request</a>. For instance, DNS results can be cached locally
330+
in the user agent, eliminating <a>DNS resolution</a> for future requests
331+
to the same domain. Similarly, HTTP <a>persistent connections</a> allow
332+
open connections to be shared for multiple requests to the same
333+
<a>origin</a>. However, if multiple <a>phases</a> occur, they will occur
334+
in the above order.
335335
</p>
336336

337337
<p class="ednote">
338-
We would like to move the definition of these phases into [[FETCH]] so
339-
that they are more reusable.
338+
We would like to move the definition of these <a>phases</a> into [[FETCH]]
339+
so that they are more reusable.
340340
</p>
341341

342342
<p>
@@ -1141,9 +1141,9 @@ <h2>Extract response headers</h2>
11411141

11421142
<dt><code>phase</code></dt>
11431143
<dd>
1144-
If <var>request</var> <a>failed</a>, the <a>phase</a> of its
1145-
<a>network error</a>. If <var>request</var> <a>succeeded</a>,
1146-
<code>"application"</code>.
1144+
If <var>request</var> <a>failed</a>, the
1145+
<a data-lt="type-phase">phase</a> of its <a>network error</a>. If
1146+
<var>request</var> <a>succeeded</a>, <code>"application"</code>.
11471147
</dd>
11481148

11491149
<dt><code>type</code></dt>
@@ -1165,9 +1165,9 @@ <h2>Extract response headers</h2>
11651165
<p class="note">
11661166
This step ensures that <a data-lt="subdomains">subdomain</a> <a>NEL
11671167
policies</a> can only be used to generate reports about subdomains of
1168-
the <a>policy origin</a> during the <a>DNS resolution</a> phase of a
1169-
<a>request</a>. See <a href="#privacy-considerations"></a> for more
1170-
details.
1168+
the <a>policy origin</a> during the <a>DNS resolution</a> <a>phase</a>
1169+
of a <a>request</a>. See <a href="#privacy-considerations"></a> for
1170+
more details.
11711171
</p>
11721172
</li>
11731173

@@ -1274,7 +1274,7 @@ <h2>DNS resolution errors</h2>
12741274

12751275
<p>
12761276
All of the <a>network errors</a> in this section occur during <a>DNS
1277-
resolution</a>, and therefore have a <a data-lt="type phase">phase</a>
1277+
resolution</a>, and therefore have a <a data-lt="type-phase">phase</a>
12781278
of <code>dns</code>.
12791279
</p>
12801280

@@ -1298,8 +1298,8 @@ <h2>Secure connection establishment errors</h2>
12981298

12991299
<p>
13001300
All of the <a>network errors</a> in this section occur during <a>secure
1301-
connection establishment</a>, and therefore have a <a data-lt="type
1302-
phase">phase</a> of <code>connection</code>.
1301+
connection establishment</a>, and therefore have a
1302+
<a data-lt="type-phase">phase</a> of <code>connection</code>.
13031303
</p>
13041304

13051305
<dl>
@@ -1367,7 +1367,7 @@ <h2>Transmission of request and response errors</h2>
13671367
<p>
13681368
All of the <a>network errors</a> in this section occur during the
13691369
<a>transmission of request and response</a>, and therefore have a <a
1370-
data-lt="type phase">phase</a> of <code>application</code>.
1370+
data-lt="type-phase">phase</a> of <code>application</code>.
13711371
</p>
13721372

13731373
<dl>
@@ -1980,12 +1980,12 @@ <h2>Privacy Considerations</h2>
19801980
<p>
19811981
Similarly, <a data-lt="subdomains">subdomain</a> <a>NEL policies</a> are
19821982
limited, and can only be used to generate reports about subdomains of the
1983-
<a>policy origin</a> during the <a>DNS resolution</a> phase of a
1984-
<a>request</a>. During this phase, there is no <a>server</a> to verify
1985-
ownership of, and the fact that the policy was received from a superdomain
1986-
of the <a>request</a>'s <a>origin</a> is enough to establish ownership of
1987-
the error. This allows the owners of a particular portion of the
1988-
<a>domain namespace tree</a> to use NEL to detect <a
1983+
<a>policy origin</a> during the <a>DNS resolution</a> <a>phase</a> of a
1984+
<a>request</a>. During this <a>phase</a>, there is no <a>server</a> to
1985+
verify ownership of, and the fact that the policy was received from a
1986+
superdomain of the <a>request</a>'s <a>origin</a> is enough to establish
1987+
ownership of the error. This allows the owners of a particular portion of
1988+
the <a>domain namespace tree</a> to use NEL to detect <a
19891989
href="#dns-misconfiguration"></a> errors, while preventing them from
19901990
using malicious DNS entries to collect information about servers they
19911991
don't control.

0 commit comments

Comments
 (0)