From 490f4af65c09fd40f27af78dcd7e037139d83c8a Mon Sep 17 00:00:00 2001
From: Matt Giuca <mgiuca@chromium.org>
Date: Fri, 12 Jan 2024 14:05:02 +1100
Subject: [PATCH] Clarify file_handlers.icons semantics (#87)

Rewrote the note to clarify the purpose and intent of file handler icons.

This properly explains that file handler icons should represent the file type, not the application, but that it can include the application logo to imply which app will open the file.

Also makes a minor change to normative text (remove "on a platform").

Closes #86.
---
 index.html | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 05737fc..aafc46c 100644
--- a/index.html
+++ b/index.html
@@ -715,15 +715,19 @@ <h3>
           <p>
             The <a>file handler</a>'s <code><dfn data-dfn-for=
             "file handler">icons</dfn></code> member lists icons that serve as
-            graphical representations of a [=file type=] on a platform. User
-            agents MAY pass this information to the operating system during
-            file handler registration.
+            graphical representations of a [=file type=]. User agents MAY pass
+            this information to the operating system during file handler
+            registration.
           </p>
           <aside class="note">
-            Semantically, the [=file handler/icons=] are used to convey the
-            file type itself and also the app. As with [=file handler/name=],
-            this is typically only displayed when the app has become the
-            default handler for a file type.
+            The [=file handler/icons=] member is expected to be an image (or
+            collection of images at different sizes) that represents all files
+            that are associated with the handler. This will typically appear
+            like a document (e.g. a piece of paper) as opposed to an
+            application logo, but might include elements (such as logos) that
+            suggest which application the file is associated with. As with
+            [=file handler/name=], this is typically only displayed when the
+            app has become the default handler for a file type.
           </aside>
         </section>
         <section>