Skip to content

Commit 1bd4be6

Browse files
authored
chore: Export the terms "manifest URL" and "start URL" (#1112)
1 parent 9d8ad08 commit 1bd4be6

File tree

1 file changed

+20
-19
lines changed

1 file changed

+20
-19
lines changed

index.html

+20-19
Original file line numberDiff line numberDiff line change
@@ -161,8 +161,8 @@ <h2>
161161
application is launched.
162162
</p>
163163
<p>
164-
A manifest has an associated <dfn>manifest URL</dfn>, which is the
165-
[[URL]] from which the <a>manifest</a> was fetched.
164+
A manifest has an associated <dfn class="export">manifest URL</dfn>,
165+
which is the [[URL]] from which the <a>manifest</a> was fetched.
166166
</p>
167167
<p>
168168
A [=manifest=] can have any of the following members at its root, all
@@ -607,8 +607,8 @@ <h3>
607607
<aside class="note" title="Default scope">
608608
<p>
609609
The "default scope" (when [=manifest/scope=] member is missing,
610-
empty, or failure) is the start URL, but with its filename, query,
611-
and fragment removed.
610+
empty, or failure) is the [=start URL=], but with its filename,
611+
query, and fragment removed.
612612
</p>
613613
</aside>
614614
<p>
@@ -759,10 +759,11 @@ <h3>
759759
<p>
760760
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
761761
"manifest">start_url</dfn></code> member is a <a>string</a> that
762-
represents the <dfn>start URL</dfn> , which is <a>URL</a> that the
763-
developer would prefer the user agent load when the user launches the
764-
web application (e.g., when the user clicks on the icon of the web
765-
application from a device's application menu or homescreen).
762+
represents the <dfn class="export">start URL</dfn> , which is
763+
<a>URL</a> that the developer would prefer the user agent load when
764+
the user launches the web application (e.g., when the user clicks on
765+
the icon of the web application from a device's application menu or
766+
homescreen).
766767
</p>
767768
<p>
768769
The [=manifest/start_url=] member is purely advisory, and a user
@@ -822,12 +823,12 @@ <h3>
822823
<p>
823824
Given the above, it is RECOMMENDED that, upon installation, or any
824825
time thereafter, a user agent allows the user to inspect and, if
825-
necessary, modify the <a>start URL</a> of an application.
826+
necessary, modify the [=start URL=] of an application.
826827
</p>
827828
<p>
828-
Additionally, developers MUST NOT use the <a>start URL</a> to
829-
include information that uniquely identifies a user (e.g.,
830-
"?user=123" or "/user/123/", or "https://user123.foo.bar").
829+
Additionally, developers MUST NOT use the [=manifest/start URL=] to include
830+
information that uniquely identifies a user (e.g., "?user=123" or
831+
"/user/123/", or "https://user123.foo.bar").
831832
</p>
832833
</section>
833834
</section>
@@ -839,7 +840,7 @@ <h3>
839840
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
840841
"manifest">id</dfn></code> member is a <a>string</a> that represents
841842
the <dfn>identity</dfn> for the application. The [=identity=] takes
842-
the form of a URL, which is same origin as the start URL.
843+
the form of a URL, which is same origin as the [=start URL=].
843844
</p>
844845
<p>
845846
The [=identity=] is used by user agents to uniquely identify the
@@ -890,8 +891,8 @@ <h3>
890891
</ol>
891892
<aside class="example" title="Resulting ids">
892893
<p>
893-
The table below shows some example `id`s resulting from the [=process
894-
the `id` member=] steps.
894+
The table below shows some example `id`s resulting from the
895+
[=process the `id` member=] steps.
895896
</p>
896897
<table class="data">
897898
<tr>
@@ -1008,10 +1009,10 @@ <h3>
10081009
<p>
10091010
Since [=manifest/id=] is resolved against [=manifest/start_url=]'s
10101011
[=URL/origin=], providing "../foo", "foo", "/foo", "./foo" all
1011-
resolves to the same [=identifier=]. As such, best practice
1012-
is to use a leading "/" to be explicit that the id is a
1013-
root-relative URL path. Also, standard encoding/decoding rules
1014-
apply to the id processing algorithm, as per the [[[URL]]].
1012+
resolves to the same [=identifier=]. As such, best practice is to
1013+
use a leading "/" to be explicit that the id is a root-relative URL
1014+
path. Also, standard encoding/decoding rules apply to the id
1015+
processing algorithm, as per the [[[URL]]].
10151016
</p>
10161017
</aside>
10171018
</section>

0 commit comments

Comments
 (0)