From 6e48c04af80b242b8e57cafd3cc5ebf4f8cfa871 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 9 Sep 2026 02:04:03 +0200
Subject: [PATCH] fix(ui): align contextual documentation with headings

Verified with the coordinated workspace changes by devkit full run
2026-09-08T225814-186389-0000-3e3ed7cd (all seven phases passed).
This shared UI pass does not mark the individual module reviews complete.
---
 src/govoplan_quick_access/backend/manifest.py | 12 ++++++++++++
 webui/src/components/QuickAccessRail.tsx      | 10 ++++++----
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/src/govoplan_quick_access/backend/manifest.py b/src/govoplan_quick_access/backend/manifest.py
index 5da3ac4..9a0683f 100644
--- a/src/govoplan_quick_access/backend/manifest.py
+++ b/src/govoplan_quick_access/backend/manifest.py
@@ -187,6 +187,9 @@ DOCUMENTATION = (
         title="Quick Access rail",
         summary="Keep selected work, calendar, message, and file tools available beside the current page.",
         body=(
+            "Documentation books sit immediately beside the visible heading or contextual label for the "
+            "displayed Quick Access tool, not among operational action buttons. Field help remains beside "
+            "its label. "
             "Open a category on the right rail to use compact tools without leaving the current task. "
             "Messages combines enabled Mail, Postbox, and future chat contributions in one overlay. "
             "Personal settings can reorder or hide items that remain available under system, tenant, "
@@ -221,6 +224,9 @@ DOCUMENTATION = (
                 "title": "Schnellzugriffsleiste",
                 "summary": "Ausgewaehlte Werkzeuge fuer Arbeit, Kalender, Nachrichten und Dateien neben der aktuellen Seite verwenden.",
                 "body": (
+                    "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                    "Kontextbezeichnung für das angezeigte Schnellzugriffswerkzeug, nicht zwischen ausführbaren "
+                    "Aktionsschaltflächen. Feldhilfe bleibt neben der Feldbezeichnung. "
                     "Eine Kategorie in der rechten Leiste oeffnet kompakte Werkzeuge, ohne die aktuelle Aufgabe zu verlassen. "
                     "Nachrichten fuehrt Beitraege aus Mail, Postfach und kuenftigen Chat-Modulen in einer Einblendung zusammen. "
                     "Persoenliche Einstellungen koennen alle durch System, Mandant, Berechtigungen und Ansicht zugelassenen Eintraege ordnen oder ausblenden. "
@@ -254,6 +260,9 @@ DOCUMENTATION = (
         title="Quick Access policy",
         summary="Govern which registered compact tools lower scopes may use and how they are ordered by default.",
         body=(
+            "Documentation books sit immediately beside the visible heading or contextual label for the "
+            "displayed Quick Access tool, not among operational action buttons. Field help remains beside "
+            "its label. "
             "The catalogue follows installed module registrations. System settings constrain tenants; "
             "tenant settings constrain users. An item may remain available, be blocked, or be forced. "
             "Effective entries identify the system, tenant, user, or module source of availability and ordering; "
@@ -273,6 +282,9 @@ DOCUMENTATION = (
                 "title": "Richtlinien fuer den Schnellzugriff",
                 "summary": "Verfuegbarkeit und Standardreihenfolge registrierter kompakter Werkzeuge steuern.",
                 "body": (
+                    "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                    "Kontextbezeichnung für das angezeigte Schnellzugriffswerkzeug, nicht zwischen ausführbaren "
+                    "Aktionsschaltflächen. Feldhilfe bleibt neben der Feldbezeichnung. "
                     "Der Katalog folgt den Registrierungen installierter Module. Systemeinstellungen begrenzen Mandanten, "
                     "Mandanteneinstellungen begrenzen Benutzer. Ein Eintrag kann verfuegbar, gesperrt oder erzwungen sein. "
                     "Effektive Eintraege nennen System, Mandant, Benutzer oder Modul als Quelle fuer Verfuegbarkeit und Reihenfolge; "
diff --git a/webui/src/components/QuickAccessRail.tsx b/webui/src/components/QuickAccessRail.tsx
index 569510d..e392e07 100644
--- a/webui/src/components/QuickAccessRail.tsx
+++ b/webui/src/components/QuickAccessRail.tsx
@@ -14,6 +14,7 @@ import { Link, useLocation } from "react-router";
 import {
   DismissibleAlert,
   DocumentationHelpLink,
+  TextWithHelp,
   IconButton,
   LoadingFrame,
   dispatchQuickAccessResult,
@@ -308,7 +309,11 @@ export default function QuickAccessRail({ settings, auth, tools, launchContext }
                   >
                     <div className="quick-access-tool-heading">
                       <div>
-                        <strong>{translateText(tool.label)}</strong>
+                        <TextWithHelp help={metadata?.helpContextId ? (
+                          <DocumentationHelpLink reference={{ contextId: metadata.helpContextId, moduleId: tool.module_id }} />
+                        ) : undefined}>
+                          <strong>{translateText(tool.label)}</strong>
+                        </TextWithHelp>
                         {recommendedToolIds.has(tool.id) ? (
                           <span className="quick-access-recommended">
                             {translateText("i18n:govoplan-quick-access.recommended_for_view")}
@@ -316,9 +321,6 @@ export default function QuickAccessRail({ settings, auth, tools, launchContext }
                         ) : null}
                         {tool.description ? <small>{translateText(tool.description)}</small> : null}
                       </div>
-                      {metadata?.helpContextId ? (
-                        <DocumentationHelpLink reference={{ contextId: metadata.helpContextId, moduleId: tool.module_id }} />
-                      ) : null}
                       {tool.full_page_path ? (
                         <button
                           type="button"