diff --git a/index.html b/index.html index 0ce6559cb..426229fa0 100644 --- a/index.html +++ b/index.html @@ -269,7 +269,7 @@
@@ -326,18 +326,48 @@
+ 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. +
+- 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]]].