Skip to content

Commit 0aa482d

Browse files
committed
Authority of the manifest's metadata: require the document to be in scope.
This introduces a small new normative requirement that the manifest NOT be applied to a document that it outside of its scope. A note explains that this only applies to the authority of the metadata, not the installation.
1 parent 5aa3e1e commit 0aa482d

File tree

1 file changed

+20
-8
lines changed

1 file changed

+20
-8
lines changed

index.html

+20-8
Original file line numberDiff line numberDiff line change
@@ -260,7 +260,7 @@ <h3>
260260
</section>
261261
</section>
262262
<section>
263-
<h2>
263+
<h2 id="installable-web-applications">
264264
Installable web applications
265265
</h2>
266266
<p>
@@ -323,13 +323,25 @@ <h3>
323323
Authority of the manifest's metadata
324324
</h3>
325325
<p>
326-
When a <a>manifest</a> is linked from a {{Document}}, it indicates to
327-
the user agent that the metadata is <dfn>authoritative</dfn>: that
328-
is, the user agent SHOULD use the metadata of the manifest instead of
329-
the one in the {{Document}}. However, in cases where metadata is
330-
missing, or in error, a user agent MAY fallback to the {{Document}}
331-
to find suitable replacements for missing manifest members (e.g.,
332-
using `application-name` in place of `short_name`).
326+
When a <a>manifest</a> is linked from a {{Document}}, and the
327+
{{Document}} is <a data-lt="within-scope-manifest">within scope</a>
328+
of the manifest, it indicates to the user agent that the metadata is
329+
<dfn>authoritative</dfn>: that is, the user agent SHOULD use the
330+
metadata of the manifest instead of the one in the {{Document}}.
331+
However, in cases where metadata is missing, or in error, a user
332+
agent MAY fallback to the {{Document}} to find suitable replacements
333+
for missing manifest members (e.g., using `application-name` in place
334+
of `short_name`). The user agent MUST NOT apply the metadata of a
335+
manifest to a {{Document}} that is not <a data-lt=
336+
"within-scope-manifest">within scope</a> of that manifest.
337+
</p>
338+
<p class="note">
339+
A {{Document}} that is not <a data-lt="within-scope-manifest">within
340+
scope</a> of a linked manifest can still be used to install the web
341+
application associated with the manifest, it just can't have the
342+
manifest's metadata applied directly to the document. See the note in
343+
<a href="#installable-web-applications">Installable web
344+
applications</a>.
333345
</p>
334346
</section>
335347
<section data-link-for="WebAppManifest">

0 commit comments

Comments
 (0)