From 730ccf2a81edb323706b356e0afb83f629535447 Mon Sep 17 00:00:00 2001
From: Guilhem Lemouel <guilhemlemouel@gmail.com>
Date: Tue, 6 Oct 2026 03:01:37 -0700
Subject: [PATCH] docs: the handle's comment describes what the handle does
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

It claimed a click holds the sidebar card open. Nothing distinguishes a click
from a hover there — both call the same opener, and the pointer leaving
schedules the close either way — so on a desktop the card follows the pointer
and goes when it goes. Measured: hovering slides the rail from -213 to 5, the
click moves nothing, and the pointer leaving puts it back at -213.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 frontend/src/lib/components/PageHeaderBar.svelte | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/frontend/src/lib/components/PageHeaderBar.svelte b/frontend/src/lib/components/PageHeaderBar.svelte
index 11b7950f54..ad9d5f0899 100644
--- a/frontend/src/lib/components/PageHeaderBar.svelte
+++ b/frontend/src/lib/components/PageHeaderBar.svelte
@@ -99,10 +99,11 @@ The row's height matches the sidebar's own header row, so the two read as one ba
 	)}
 >
 	{#if (navDetached.val || panelled) && !navHidden}
-		<!-- Reveals the hidden sidebar, and only that: hovering slides the card in, clicking holds
-		     it there. Attaching it for good belongs to the toggle in the sidebar's own footer, where
-		     detaching it happened — a control that hides the thing it sits on cannot also be the
-		     way to bring it back. Docked, the sidebar speaks for itself and nothing leads the bar. -->
+		<!-- Reveals the hidden sidebar, and only that: the card follows the pointer, holding while it
+		     is on the handle, on the card, or in a menu either opened, and sliding back out when it
+		     leaves. Where no pointer hovers, a tap opens it and it stays until dismissed. Attaching
+		     it for good belongs to the toggle in the sidebar's own footer, where detaching it
+		     happened. Docked, the sidebar speaks for itself and nothing leads the bar. -->
 		<!-- svelte-ignore a11y_no_static_element_interactions -->
 		<div
 			data-nav-handle