diff --git a/index.html b/index.html index 0ce6559cb..426229fa0 100644 --- a/index.html +++ b/index.html @@ -269,7 +269,7 @@

-

+

Installable web applications

@@ -326,18 +326,48 @@

(at the user agent's discretion; see [[[#installability-signals]]]). +
+

+ The {{Document}} might not be within scope of the linked manifest, by + design. For example, a page at https://example.com might + link a manifest with scope "/installable/", + allowing the top-level page of the site (which itself is not part of + the installable web application) to show installation UI. +

+

+ Implementors need to be aware of this possibility. One consequence is + that if, post install, the user agent opens the document URL in an + application context, it would immediately start showing the + "out of scope" warning UI (that is recommended in + [[[#navigation-scope]]]). Hence, implementors might wish to avoid + doing this if the {{Document}} is out of scope. +

+

Authority of the manifest's metadata

- When a manifest is linked from a {{Document}}, it indicates to - the user agent that the metadata is authoritative: that - is, the user agent SHOULD use the metadata of the manifest instead of - the one in the {{Document}}. However, in cases where metadata is - missing, or in error, a user agent MAY fallback to the {{Document}} - to find suitable replacements for missing manifest members (e.g., - using `application-name` in place of `short_name`). + When a manifest is linked from a {{Document}}, and the + {{Document}} is within scope + of the manifest, it indicates to the user agent that the metadata is + authoritative: that is, the user agent SHOULD use the + metadata of the manifest instead of the one in the {{Document}}. + However, in cases where metadata is missing, or in error, a user + agent MAY fallback to the {{Document}} to find suitable replacements + for missing manifest members (e.g., using `application-name` in place + of `short_name`). The user agent MUST NOT apply the metadata of a + manifest to a {{Document}} that is not within scope of that manifest. +

+

+ A {{Document}} that is not within + scope of a linked manifest can still be used to install the web + application associated with the manifest, it just can't have the + manifest's metadata applied directly to the document. See the note in + [[[#installable-web-applications]]].

@@ -839,7 +869,7 @@

-

+