Skip to content

Commit 4f070e8

Browse files
authored
Editorial: Fix broken links/fragments (#1760)
* fix broken links/fragments
1 parent 0a61792 commit 4f070e8

File tree

1 file changed

+19
-18
lines changed

1 file changed

+19
-18
lines changed

docs/index.bs

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -59,9 +59,9 @@ spec:urlpattern; type:dfn; text:match
5959
<pre class="anchors">
6060
spec: push; urlPrefix: https://w3c.github.io/push-api/
6161
type: event
62-
text: push; url: h-the-push-event
62+
text: push; url: pushevent-interface
6363

64-
spec: ecma-262; urlPrefix: http://tc39.github.io/ecma262/
64+
spec: ecma-262; urlPrefix: https://tc39.es/ecma262/
6565
type: abstract-op
6666
text: NormalCompletion; url: sec-normalcompletion
6767
text: ThrowCompletion; url: sec-throwcompletion
@@ -88,27 +88,28 @@ spec: ecma-262; urlPrefix: http://tc39.github.io/ecma262/
8888
text: statement
8989
text: declaration
9090

91-
spec: page-visibility; urlPrefix: https://www.w3.org/TR/page-visibility/
92-
type: enum; text: VisibilityState; url: VisibilityState
93-
type: attribute; text: visibilityState; for: Document; url: dom-document-visibilitystate
94-
9591
spec: html; urlPrefix: https://html.spec.whatwg.org/multipage/
9692
type: attribute
9793
urlPrefix: comms.html
9894
text: origin; for: MessageEvent; url: dom-messageevent-origin
9995
text: source; for: MessageEvent; url: dom-messageevent-source
10096
text: ports; for: MessageEvent; url: dom-messageevent-ports
10197
text: data; for: MessageEvent; url: dom-messageevent-data
98+
urlPrefix: interaction.html
99+
text: visibilityState; for: Document; url: page-visibility
102100
type: dfn
103-
urlPrefix: browsers.html
101+
urlPrefix: nav-history-apis.html
104102
text: ancestor origins list; for: Location; url: concept-location-ancestor-origins-list
105103
urlPrefix: syntax.html
106104
text: delay the load event; for: document; url: delay-the-load-event
107-
urlPrefix: origin.html
105+
urlPrefix: browsers.html
108106
text: creating a policy container from a fetch response
109107
urlPrefix: webappapis.html
110108
text: module map; url: module-map
111109
text: resolve a module specifier; url: resolve-a-module-specifier
110+
type: enum
111+
urlPrefix: interaction.html
112+
text: VisibilityState; url: page-visibility
112113

113114
spec: fetch; urlPrefix: https://fetch.spec.whatwg.org/
114115
type: dfn
@@ -123,11 +124,11 @@ spec: rfc8288; urlPrefix: https://tools.ietf.org/html/rfc8288
123124
text: target attributes; url: section-3.4
124125
text: link target; url: section-3.1
125126

126-
spec: rfc7230; urlPrefix: https://tools.ietf.org/html/rfc7230
127+
spec: rfc7230; urlPrefix: https://datatracker.ietf.org/doc/html/rfc7230
127128
type: dfn
128129
text: field-value; for: http; url: section-3.2
129130

130-
spec: rfc7231; urlPrefix: https://tools.ietf.org/html/rfc7231
131+
spec: rfc7231; urlPrefix: https://datatracker.ietf.org/doc/html/rfc7231
131132
type: dfn
132133
text: Vary; url: section-7.1.4
133134

@@ -161,9 +162,9 @@ spec: storage; urlPrefix: https://storage.spec.whatwg.org/
161162

162163
Web developers familiar with previous attempts to solve the offline problem have reported a deficit of flexibility in those solutions. As a result, the [=/service worker=] is highly procedural, providing a maximum of flexibility at the price of additional complexity for developers. Part of this complexity arises from the need to keep [=/service workers=] responsive in the face of a single-threaded execution model. As a result, APIs exposed by [=/service workers=] are almost entirely asynchronous, a pattern familiar in other JavaScript contexts but accentuated here by the need to avoid blocking document and resource loading.
163164

164-
Developers using the <a href="https://developer.mozilla.org/docs/Web/API/Window/applicationCache">HTML5 Application Cache</a> have also <a href="http://alistapart.com/article/application-cache-is-a-douchebag">reported that several attributes</a> of the design contribute to <a href="http://alistapart.com/article/application-cache-is-a-douchebag#section6">unrecoverable errors</a>. A key design principle of the [=/service worker=] is that errors should *always* be recoverable. Many details of the update process of [=/service workers=] are designed to avoid these hazards.
165+
Developers using the <a href="https://www.w3.org/TR/2014/REC-html5-20141028/browsers.html#appcache">HTML5 Application Cache</a> have also <a href="https://alistapart.com/article/application-cache-is-a-douchebag/">reported that several attributes</a> of the design contribute to <a href="https://alistapart.com/article/application-cache-is-a-douchebag/#section6">unrecoverable errors</a>. A key design principle of the [=/service worker=] is that errors should *always* be recoverable. Many details of the update process of [=/service workers=] are designed to avoid these hazards.
165166

166-
[=/Service workers=] are started and kept alive by their relationship to events, not documents. This design borrows heavily from developer and vendor experience with [[HTML#shared-workers-and-the-sharedworker-interface|shared workers]] and <a href="https://developer.chrome.com/extensions/background_pages">Chrome Background Pages</a>. A key lesson from these systems is the necessity to time-limit the execution of background processing contexts, both to conserve resources and to ensure that background context loss and restart is top-of-mind for developers. As a result, [=/service workers=] bear more than a passing resemblance to <a href="https://developer.chrome.com/extensions/event_pages">Chrome Event Pages</a>, the successor to Background Pages. [=/Service workers=] may be started by user agents *without an attached document* and may be killed by the user agent at nearly any time. Conceptually, [=/service workers=] can be thought of as Shared Workers that can start, process events, and die without ever handling messages from documents. Developers are advised to keep in mind that [=/service workers=] may be started and killed many times a second.
167+
[=/Service workers=] are started and kept alive by their relationship to events, not documents. This design borrows heavily from developer and vendor experience with [[HTML#shared-workers-and-the-sharedworker-interface|shared workers]] and <a href="https://developer.chrome.com/docs/extensions/mv2/background-pages">Chrome Background Pages</a>. A key lesson from these systems is the necessity to time-limit the execution of background processing contexts, both to conserve resources and to ensure that background context loss and restart is top-of-mind for developers. As a result, [=/service workers=] bear more than a passing resemblance to <a href="https://developer.chrome.com/docs/apps/event_pages">Chrome Event Pages</a>, the successor to Background Pages. [=/Service workers=] may be started by user agents *without an attached document* and may be killed by the user agent at nearly any time. Conceptually, [=/service workers=] can be thought of as Shared Workers that can start, process events, and die without ever handling messages from documents. Developers are advised to keep in mind that [=/service workers=] may be started and killed many times a second.
167168

168169
[=/Service workers=] are generic, event-driven, time-limited script contexts that run at an origin. These properties make them natural endpoints for a range of runtime services that may outlive the context of a particular document, e.g. handling push notifications, background data synchronization, responding to resource requests from other origins, or receiving centralized updates to expensive-to-calculate data (e.g., geolocation or gyroscope).
169170
</section>
@@ -356,7 +357,7 @@ spec: storage; urlPrefix: https://storage.spec.whatwg.org/
356357
Otherwise, it is set to the [=active service worker=] of the [=environment settings object=] of the last [=set/item=] in the [=worker client=]'s [=/global object=]'s [=owner set=].
357358
</section>
358359

359-
Note: [=Window clients=] and [=worker clients=] with a [data: URL](https://tools.ietf.org/html/rfc2397#section-2) result in having the [=active service worker=] value of null as their [=/origin=] is an [=opaque origin=]. [=Window clients=] and [=worker clients=] with a [=blob URL=] can inherit the [=active service worker=] of their creator [=/document=] or owner, but if the [=/request=]'s [=request/origin=] is not the [=same origin|same=] as the [=/origin=] of their creator [=/document=] or owner, the [=active service worker=] is set to null.
360+
Note: [=Window clients=] and [=worker clients=] with a [data: URL](https://datatracker.ietf.org/doc/html/rfc2397#section-2) result in having the [=active service worker=] value of null as their [=/origin=] is an [=opaque origin=]. [=Window clients=] and [=worker clients=] with a [=blob URL=] can inherit the [=active service worker=] of their creator [=/document=] or owner, but if the [=/request=]'s [=request/origin=] is not the [=same origin|same=] as the [=/origin=] of their creator [=/document=] or owner, the [=active service worker=] is set to null.
360361
</section>
361362

362363
<section>
@@ -1877,10 +1878,10 @@ spec: storage; urlPrefix: https://storage.spec.whatwg.org/
18771878
<td>The [=/http fetch=] invokes <a>Handle Fetch</a> with |request|. As a result of performing <a>Handle Fetch</a>, the [=ServiceWorkerGlobalScope/service worker=] returns a [=/response=] to the [=/http fetch=]. The [=/response=], represented by a {{Response}} object, can be retrieved from a {{Cache}} object or directly from network using {{WindowOrWorkerGlobalScope/fetch(input, init)|self.fetch(input, init)}} method. (A custom {{Response}} object can be another option.)</td>
18781879
</tr>
18791880
<tr>
1880-
<td><a href="https://w3c.github.io/push-api/#dfn-push">push</a></td>
1881+
<td><a href="https://w3c.github.io/push-api/#pushevent-interface">push</a></td>
18811882
<td><a href="https://w3c.github.io/push-api/#dom-pushevent"><code>PushEvent</code></a></td>
18821883
<td>[=Functional event|Functional=]</td>
1883-
<td>(See <a href="https://w3c.github.io/push-api/#dfn-fire-the-push-event">Firing a push event</a>.)</td>
1884+
<td>(See <a href="https://w3c.github.io/push-api/#receiving-a-push-message">Firing a push event</a>.)</td>
18841885
</tr>
18851886
<tr>
18861887
<td><a href="https://notifications.spec.whatwg.org/#dom-serviceworkerglobalscope-onnotificationclick">notificationclick</a></td>
@@ -1895,10 +1896,10 @@ spec: storage; urlPrefix: https://storage.spec.whatwg.org/
18951896
<td>(See <a href="https://notifications.spec.whatwg.org/#closing-a-notification">Closing a notification.</a>)</td>
18961897
</tr>
18971898
<tr>
1898-
<td><a href="https://wicg.github.io/BackgroundSync/spec/#sync">sync</a></td>
1899-
<td><a href="https://wicg.github.io/BackgroundSync/spec/#syncevent"><code>SyncEvent</code></a></td>
1899+
<td><a href="https://wicg.github.io/background-sync/spec/#syncevent">sync</a></td>
1900+
<td><a href="https://wicg.github.io/background-sync/spec/#syncevent"><code>SyncEvent</code></a></td>
19001901
<td>[=Functional event|Functional=]</td>
1901-
<td>(See <a href="https://wicg.github.io/BackgroundSync/spec/#fire-a-sync-event">Firing a sync event</a>.)</td>
1902+
<td>(See <a href="https://wicg.github.io/background-sync/spec/#fire-a-sync-event">Firing a sync event</a>.)</td>
19021903
</tr>
19031904
<tr>
19041905
<td><a href="https://w3c.github.io/payment-handler/#the-canmakepaymentevent">canmakepayment</a></td>

0 commit comments

Comments
 (0)