Skip to content

Commit d250e64

Browse files
committed
Fix Bikeshed errors/warnings
Fixes some definition links, algorithm name, example ID, and RFC2119 keyword lint warning.
1 parent 39d25f6 commit d250e64

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

fetch.bs

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2141,7 +2141,7 @@ Unless stated otherwise, it is false.
21412141
<p>A <a for=/>request</a> has an associated
21422142
<dfn export for=request id=https-upgrade-fallback-url>https-upgrade-fallback-url</dfn>. It is a copy
21432143
of the <a for=/>request</a>'s original <a for=/>URL</a> before <a for=/>request</a> is
2144-
<a for="#https-upgrades-upgrade">optionally upgraded to HTTPS</a>. Unless stated otherwise, it is
2144+
<a href="#https-upgrades-upgrade">optionally upgraded to HTTPS</a>. Unless stated otherwise, it is
21452145
unset.
21462146

21472147
<p class=note>This flag is for exclusive use by https-upgrades algorithm.
@@ -3252,11 +3252,11 @@ through TLS using ALPN. The protocol cannot be spoofed through HTTP requests in
32523252

32533253
<h3 id=https-upgrades>HTTPS upgrading</h3>
32543254

3255-
<div algorithm>
3255+
<div algorithm="https-upgrades">
32563256

3257-
<p>User agents may optionally upgrade requests with <a>potentially untrustworthy URL</a>s
3258-
to attempt to fetch them over <a>potentially trustworthy URL</a>s. If an upgraded request
3259-
fails with a network error, it is retried over the original URL.
3257+
<p>User agents may optionally upgrade requests with URLs that are not
3258+
<a>potentially trustworthy URLs</a> to attempt to fetch them over <a>potentially trustworthy URL</a>s.
3259+
If an upgraded request fails with a network error, it is retried over the original URL.
32603260

32613261
<p>The HTTPS upgrading algorithm consists of Upgrade and Fallback algorithms, with the following
32623262
steps:
@@ -3280,9 +3280,10 @@ steps:
32803280
<li><p><var>request</var>'s <a for="request">URL</a>'s <a for="url">host</a> is exempted from
32813281
upgrades in an <a>implementation-defined</a> way.
32823282

3283-
<p class="example">If <a for=url>host</a> is a non-registrable or non-assignable domain name
3284-
such as .local or an IP address that falls in a range reserved for non-publicly routable
3285-
networks, the implementation might return without modifying <var>request</var>.
3283+
<p class="example" id="example-https-upgrades-exempted-hosts">If <a for=url>host</a> is a
3284+
non-registrable or non-assignable domain name such as .local or an IP address that falls in a
3285+
range reserved for non-publicly routable networks, the implementation might return without
3286+
modifying <var>request</var>.
32863287
</ul>
32873288
</li>
32883289

@@ -3313,7 +3314,7 @@ To run <dfn>HTTPS upgrade fallback</dfn> given a <a for=/>request</a>
33133314
<p>If <var>response</var> is a network error, run the following steps:
33143315
<p class="note">This means that the upgrade failed and initiates a fallback load.
33153316
<ol>
3316-
<li><p>Let <var>fallbackResponse</var> be a new <a>Response</a> with its <code>Location</code> header set to
3317+
<li><p>Let <var>fallbackResponse</var> be a new <a for=/>Response</a> with its <code>Location</code> header set to
33173318
<code>https-upgrade-fallback-url</code>, and its <a for="response">status</a> set to 307.
33183319
<li>Return <var>fallbackResponse</var>.
33193320
</ol>
@@ -3324,12 +3325,12 @@ To run <dfn>HTTPS upgrade fallback</dfn> given a <a for=/>request</a>
33243325
</ol>
33253326

33263327
<p class=note>
3327-
User agents may implement an optional fast-fallback path by canceling slow fetches on upgraded
3328-
requests and quickly initiate a fallback http load.
3328+
User agents can implement a fast-fallback path by canceling slow fetches on upgraded
3329+
requests, in order to quickly initiate a fallback http load.
33293330

33303331
</div>
33313332

3332-
<h4>Examples</h4>
3333+
<h4 id=http-upgrades-examples>Examples</h4>
33333334

33343335
<div id=example-https-upgrade-good-https class=example>
33353336
<p>

0 commit comments

Comments
 (0)