From d6a7aa5c3c89672c6cb16ec89c8a2e987c23d7fd Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sun, 12 Apr 2026 20:41:50 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Enhance=20STOP=20butt?=
 =?UTF-8?q?on=20with=20accessible=20tooltip=20and=20description?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: manupawickramasinghe <73810867+manupawickramasinghe@users.noreply.github.com>
---
 .Jules/palette.md                           | 4 ++++
 app/src/main/res/layout/fragment_camera.xml | 2 ++
 app/src/main/res/values/strings.xml         | 1 +
 3 files changed, 7 insertions(+)

diff --git a/.Jules/palette.md b/.Jules/palette.md
index 5e5130d..5896b73 100644
--- a/.Jules/palette.md
+++ b/.Jules/palette.md
@@ -29,3 +29,7 @@
 ## 2026-04-11 - Prevent unreadable hardcoded text sizing
 **Learning:** Hardcoding `android:textSize="12sp"` directly on Android TextView elements creates an accessibility barrier for users with poor vision and ignores system-level font scaling preferences, particularly for dynamic data fields like bitrate readouts.
 **Action:** Remove overly restrictive `android:textSize` attributes from informational UI elements, allowing them to inherit accessible default text sizes from the application theme.
+
+## 2025-10-21 - Accessible Tooltips for Destructive Actions
+**Learning:** Action buttons like "STOP" with brief labels may not convey their full impact (e.g., stopping the stream AND exiting the server) to all users, particularly those relying on screen readers or keyboard navigation.
+**Action:** Enhance brief or destructive action buttons by providing both `android:contentDescription` and `android:tooltipText` with explicit descriptions of the outcome, ensuring clarity for assistive technologies and mouse/keyboard hover states.
diff --git a/app/src/main/res/layout/fragment_camera.xml b/app/src/main/res/layout/fragment_camera.xml
index 3714d5d..3a830c0 100644
--- a/app/src/main/res/layout/fragment_camera.xml
+++ b/app/src/main/res/layout/fragment_camera.xml
@@ -90,6 +90,8 @@
                             android:layout_height="wrap_content"
                             android:layout_gravity="end|fill_vertical"
                             android:includeFontPadding="false"
+                            android:contentDescription="@string/stop_button_desc"
+                            android:tooltipText="@string/stop_button_desc"
                             android:text="@string/stop_button" />
                     </LinearLayout>
 
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index f77ec82..39136d3 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -20,6 +20,7 @@
     <!-- Camera Fragment Strings -->
     <string name="app_title">RemoteCam</string>
     <string name="stop_button">STOP</string>
+    <string name="stop_button_desc">Stop camera server</string>
     <string name="preview_label">Preview</string>
     <string name="stream_label">Stream</string>
     <string name="rtsp_label">RTSP</string>