Skip to content

Commit f897c44

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 f8f227e commit f897c44

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
@@ -269,7 +269,7 @@ <h3>
269269
</section>
270270
</section>
271271
<section>
272-
<h2>
272+
<h2 id="installable-web-applications">
273273
Installable web applications
274274
</h2>
275275
<p>
@@ -331,13 +331,25 @@ <h3>
331331
Authority of the manifest's metadata
332332
</h3>
333333
<p>
334-
When a <a>manifest</a> is linked from a {{Document}}, it indicates to
335-
the user agent that the metadata is <dfn>authoritative</dfn>: that
336-
is, the user agent SHOULD use the metadata of the manifest instead of
337-
the one in the {{Document}}. However, in cases where metadata is
338-
missing, or in error, a user agent MAY fallback to the {{Document}}
339-
to find suitable replacements for missing manifest members (e.g.,
340-
using `application-name` in place of `short_name`).
334+
When a <a>manifest</a> is linked from a {{Document}}, and the
335+
{{Document}} is <a data-lt="within-scope-manifest">within scope</a>
336+
of the manifest, it indicates to the user agent that the metadata is
337+
<dfn>authoritative</dfn>: that is, the user agent SHOULD use the
338+
metadata of the manifest instead of the one in the {{Document}}.
339+
However, in cases where metadata is missing, or in error, a user
340+
agent MAY fallback to the {{Document}} to find suitable replacements
341+
for missing manifest members (e.g., using `application-name` in place
342+
of `short_name`). The user agent MUST NOT apply the metadata of a
343+
manifest to a {{Document}} that is not <a data-lt=
344+
"within-scope-manifest">within scope</a> of that manifest.
345+
</p>
346+
<p class="note">
347+
A {{Document}} that is not <a data-lt="within-scope-manifest">within
348+
scope</a> of a linked manifest can still be used to install the web
349+
application associated with the manifest, it just can't have the
350+
manifest's metadata applied directly to the document. See the note in
351+
<a href="#installable-web-applications">Installable web
352+
applications</a>.
341353
</p>
342354
</section>
343355
<section data-link-for="WebAppManifest">

0 commit comments

Comments
 (0)