diff --git a/index.html b/index.html index 82fd8c8f..092c9b6e 100644 --- a/index.html +++ b/index.html @@ -300,27 +300,41 @@

Declaring multiple icons

- In the following example, the developer has made the following - choices about the icons associated with the web application: + This section illustrates how to declare multiple icons using the + [=manifest/icons=] member to declare a set of icons for a web + application. In the following example, the developer has made the + following choices about the icons associated with the web + application:

+

+ The list of icons is provided to the user agent, which will choose + the most suitable icons for different contexts and placements. +

             {
               "icons": [
@@ -335,8 +349,7 @@ 

"src": "icon/hd_hi.ico", "sizes": "72x72 96x96 128x128 256x256" },{ - "src": "icon/hd_hi.svg", - "sizes": "257x257" + "src": "icon/hd_hi.svg" }] }

@@ -431,9 +444,9 @@

path of the [=manifest/start_url=] member is used as a fallback. And if the [=manifest/start_url=] member is also missing, then the document URL from which the web application is installed gets used - as the scope. To be sure you don't get any unexpected navigation - behavior, always include a [=manifest/scope=] member preferably set - to `"/"`. + as the scope. To avoid any unexpected navigation behavior, authors + should always include a [=manifest/scope=] member preferably set to + `"/"`.

@@ -3206,10 +3219,10 @@

recognize or support.

- If you are writing a specification and temporarily want to patch this - specification to help implementations along, file a bug so the - community is informed of what you are trying to do. + community is informed of what editors are trying to do.

@@ -3233,8 +3246,8 @@

short name of that proprietary ecosystem to avoid name collisions.

- Do not use vendor prefixes that you intend to later remove once it - becomes a standard (those tend to stick around forever). Only use + Do not use vendor prefixes that are intended for later removal once + they become standard (those tend to stick around forever). Only use prefixes that will make sense now and into the future.

@@ -3382,8 +3395,8 @@

"https://schemastore.org/json/">schemastore.org. It is licensed under Apache 2.0. It is kindly maintained by Mads Kristensen. If you find - any issues with the JSON schema, please Mads Kristensen. If developers + find any issues with the JSON schema, please file a bug at the SchemaStore repository on GitHub.