From 1e880618bb4022c945fa8a99f9d2a46d1626c120 Mon Sep 17 00:00:00 2001
From: Marcos Caceres <caceres_m@apple.com>
Date: Wed, 3 Sep 2025 16:02:15 +1000
Subject: [PATCH 1/2] Add Accessibility considerations section

---
 index.html | 67 ++++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 60 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 63932c1..4b33cc0 100644
--- a/index.html
+++ b/index.html
@@ -195,7 +195,7 @@ <h2>
       </p>
     </section>
     <section id="presentation">
-      <h2>
+      <h2 id="displaying-a-badge">
         Displaying a badge
       </h2>
       <p>
@@ -386,12 +386,65 @@ <h2>
         system load, user preferences, and accessibility considerations.
       </p>
     </section>
-    <section class="informative">
-      <h2>
-        Accessibility considerations
-      </h2>
-      <div class="issue" data-number="24"></div>
-    </section>
+    <h2>
+      Accessibility considerations
+    </h2>
+    <p>
+      Application badges convey status that can require the user's attention.
+      Because badges are often presented outside the web content area (for
+      example, on an app icon in the dock), user agents need to ensure that the
+      information remains accessible and controllable through platform
+      accessibility features and user preferences.
+    </p>
+    <h3>
+      Screen reader compatibility
+    </h3>
+    <p>
+      User agents SHOULD expose the current [=badge/value=] (including
+      [="flag"=] vs. [=number=]) through platform accessibility APIs so that
+      assistive technologies can present it on demand (for example, when the
+      user focuses the application icon).
+    </p>
+    <p>
+      User agents <em>SHOULD NOT</em> automatically announce badge changes;
+      instead, they SHOULD follow platform conventions that avoid unsolicited
+      interruptions.
+    </p>
+    <h3 class="informative">
+      Visual accessibility
+    </h3>
+    <p>
+      As badges are typically drawn by the underlying platform, visual
+      affordances are typically handled there. Nevertheless, user agents and
+      platforms need to consider:
+    </p>
+    <ul>
+      <li>Do not rely on color alone to convey meaning (provide text or an
+      accessible name).
+      </li>
+      <li>Ensure sufficient non-text contrast between badge glyph and
+      background.
+      </li>
+      <li>Use sizing that remains legible across system font/scale settings.
+      </li>
+      <li>Honor high-contrast / forced-colors and dark mode preferences where
+      applicable.
+      </li>
+      <li>If animating badge changes, honor reduced-motion preferences and
+      avoid flashing effects.
+      </li>
+    </ul>
+    <h3>
+      Platform integration and user preferences
+    </h3>
+    <p>
+      User agents SHOULD integrate with platform accessibility settings and
+      themes.
+    </p>
+    <p>
+      User agents SHOULD reflect OS-level per-application badge preferences
+      (for example, when the operating system disables badges for an app).
+    </p>
     <section id="conformance"></section>
   </body>
 </html>

From addd69488064a9f8d8f8d5a82cd2c60ebc547896 Mon Sep 17 00:00:00 2001
From: Marcos Caceres <caceres_m@apple.com>
Date: Thu, 25 Sep 2025 20:18:45 +1000
Subject: [PATCH 2/2] fix xrefs

---
 index.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/index.html b/index.html
index 4b33cc0..338e8ab 100644
--- a/index.html
+++ b/index.html
@@ -401,9 +401,9 @@ <h3>
     </h3>
     <p>
       User agents SHOULD expose the current [=badge/value=] (including
-      [="flag"=] vs. [=number=]) through platform accessibility APIs so that
-      assistive technologies can present it on demand (for example, when the
-      user focuses the application icon).
+      [=badge/"flag"=] vs. [=badge/number=]) through platform accessibility
+      APIs so that assistive technologies can present it on demand (for
+      example, when the user focuses the application icon).
     </p>
     <p>
       User agents <em>SHOULD NOT</em> automatically announce badge changes;