From 958a9959c8731fa7734dfaf72ae7dc467086eef6 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 9 Sep 2026 02:03:29 +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_addresses/backend/manifest.py         | 2 ++
 webui/src/features/addressbook/AddressBookPage.tsx | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/govoplan_addresses/backend/manifest.py b/src/govoplan_addresses/backend/manifest.py
index 104b212..90bf949 100644
--- a/src/govoplan_addresses/backend/manifest.py
+++ b/src/govoplan_addresses/backend/manifest.py
@@ -714,6 +714,7 @@ manifest = ModuleManifest(
             title="Reusable address ownership",
             summary="Reusable person, organization, household, postal, and email recipient sources belong to the addresses module.",
             body=(
+                "Open the book beside Address books for documentation of the address workspace. "
                 "Campaigns may keep immutable campaign-local recipient snapshots, but durable address directories, "
                 "recipient-source definitions, consent metadata, provenance, deduplication, and import/export workflows "
                 "are owned by govoplan-addresses. The Address Book workspace keeps Reload directly "
@@ -746,6 +747,7 @@ manifest = ModuleManifest(
                         "Addresses-Modul."
                     ),
                     "body": (
+                        "Öffnen Sie das Buch neben Adressbücher für die Dokumentation des Adressarbeitsbereichs. "
                         "Campaigns darf unveränderliche campaignlokale Empfänger-Snapshots halten. Dauerhafte Adressverzeichnisse, "
                         "Empfängerquellendefinitionen, Einwilligungsmetadaten, Herkunft, Dublettenbereinigung sowie Import- und Exportabläufe "
                         "gehören jedoch govoplan-addresses. Im Adressbuch steht Neuladen oben rechts unmittelbar vor "
diff --git a/webui/src/features/addressbook/AddressBookPage.tsx b/webui/src/features/addressbook/AddressBookPage.tsx
index 8ebb36f..c85e3c7 100644
--- a/webui/src/features/addressbook/AddressBookPage.tsx
+++ b/webui/src/features/addressbook/AddressBookPage.tsx
@@ -3242,6 +3242,8 @@ export default function AddressBookPage({ settings, auth, onAuthChange }: Props)
   return (
     <div className="workspace-data-page module-entry-page address-book-page address-book-fullscreen">
       <PageActionBar
+        title="Address books"
+        titleHelp={<DocumentationHelpLink reference={ADDRESSES_DOCUMENTATION} />}
         variant="collection"
         label="i18n:govoplan-addresses.explorer.page_actions"
         className="address-page-actions"
@@ -3252,7 +3254,6 @@ export default function AddressBookPage({ settings, auth, onAuthChange }: Props)
           <Button type="button" onClick={() => setAddressActionsOpen("connections")} disabledReason={savingReason}><Link2 size={16} aria-hidden="true" /> i18n:govoplan-addresses.explorer.connections</Button>
           <Button type="button" onClick={() => void openQualityReview()} disabledReason={qualityDashboardReason}><ShieldCheck size={16} aria-hidden="true" /> i18n:govoplan-addresses.explorer.quality</Button>
         </>}
-        helpAction={<DocumentationHelpLink reference={ADDRESSES_DOCUMENTATION} />}
         createAction={<Button type="button" variant="primary" onClick={openCreateBookDialog} disabledReason={createBookReason}><Plus size={16} aria-hidden="true" /> Add address book</Button>}
       />
       {error && <DismissibleAlert className="address-error" compact tone="danger" resetKey={error}>{error}</DismissibleAlert>}