Re: [w3c/manifest] Add a 'masking' purpose, for allowing the UA to supercompose such icons (#657)

anssiko requested changes on this pull request.



> @@ -2499,6 +2524,14 @@ <h3>
             A user agent can present this icon where space constraints and/or
             color requirements differ from those of the application icon.
           </dd>
+          <dt>
+            <dfn data-lt="badge maskable">maskable</dfn>:
+          </dt>
+          <dd>
+            The image is designed with <a href="#icon-masks">maskable</a> in mind,

If you want to link to the "Icon masks and safe zone" section and not to the `maskable` definition, it'd be better to expand `<a href="#icon-masks">icon masks and safe zone</a>`.

(`<a>markable</a>` should work if you link to its definition.)

> @@ -2570,6 +2603,143 @@ <h3>
           </pre>
         </div>
       </section>
+      <section>
+        <h2><a id="icon-masks"></a>
+          Icon masks and safe zone
+        </h2>
+        <p>
+          Some platforms have their own preferred icon shape, but as web
+          applications should work across multiple platforms, it is possible to
+          indicate that an icon may have a user-agent-specified mask applied by

I'd prefer to use non-normative language in this para i.e. s/may/can/g and list normative statement in the list below.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/w3c/manifest/pull/657#pullrequestreview-152014209