From 965244fc67ffe8106225d36c4da967c93987c87b Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 9 Sep 2026 02:04:16 +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_search/backend/manifest.py        |  6 ++++++
 webui/src/components/GlobalSearch.tsx          | 10 +++++-----
 webui/src/features/search/SearchAdminPanel.tsx | 10 +++++-----
 webui/src/features/search/SearchPage.tsx       | 10 +++++-----
 4 files changed, 21 insertions(+), 15 deletions(-)

diff --git a/src/govoplan_search/backend/manifest.py b/src/govoplan_search/backend/manifest.py
index e0b7e87..8b85f01 100644
--- a/src/govoplan_search/backend/manifest.py
+++ b/src/govoplan_search/backend/manifest.py
@@ -304,6 +304,9 @@ manifest = ModuleManifest(
                 "permission-aware interface."
             ),
             body=(
+                "Documentation books sit immediately beside the visible heading or contextual label for "
+                "Search and Search index, not among operational action buttons. Field help remains beside its "
+                "label. "
                 "Search works with the built-in database index and can aggregate "
                 "optional providers. Source modules announce searchable types, "
                 "context scopes, and ACL-aware index entries. External engines "
@@ -379,6 +382,9 @@ manifest = ModuleManifest(
                         "berechtigungsbewusste Oberfläche finden."
                     ),
                     "body": (
+                        "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                        "Kontextbezeichnung für Suche und Suchindex, nicht zwischen ausführbaren "
+                        "Aktionsschaltflächen. Feldhilfe bleibt neben der Feldbezeichnung. "
                         "Search verwendet den eingebauten Datenbankindex und kann optionale Anbieter "
                         "zusammenführen. Quellmodule melden durchsuchbare Typen, Kontextbereiche und "
                         "berechtigungsgeprüfte Indexeinträge. Externe Suchmaschinen bleiben optionale "
diff --git a/webui/src/components/GlobalSearch.tsx b/webui/src/components/GlobalSearch.tsx
index 85dcf96..76e13d7 100644
--- a/webui/src/components/GlobalSearch.tsx
+++ b/webui/src/components/GlobalSearch.tsx
@@ -194,7 +194,10 @@ export default function GlobalSearch({ settings, auth }: GlobalSearchProps) {
 
       <Dialog
         open={open && Boolean(layout)}
-        title="Search"
+        title="Search" titleHelp={<DocumentationHelpLink
+                reference={{ topicId: "search.global-and-contextual", documentationType: "user" }}
+                label="Open search documentation"
+              />}
         helpContextId="search.results"
         onClose={closeOverlay}
         showCloseButton={false}
@@ -280,10 +283,7 @@ export default function GlobalSearch({ settings, auth }: GlobalSearchProps) {
                 hideModules={Boolean(context)} onModulesChange={setModules}
                 onResourceTypesChange={setResourceTypes} onClear={clearFilters} />
               {loading && <LoadingIndicator size="sm" label="Searching" />}
-              <DocumentationHelpLink
-                reference={{ topicId: "search.global-and-contextual", documentationType: "user" }}
-                label="Open search documentation"
-              />
+
               <IconButton
                 label="Close search"
                 icon={<X size={17} />}
diff --git a/webui/src/features/search/SearchAdminPanel.tsx b/webui/src/features/search/SearchAdminPanel.tsx
index e22f54d..b14e757 100644
--- a/webui/src/features/search/SearchAdminPanel.tsx
+++ b/webui/src/features/search/SearchAdminPanel.tsx
@@ -192,7 +192,10 @@ export default function SearchAdminPanel({ settings }: Props) {
 
   return (
     <AdminPageLayout
-      title="Search index"
+      title="Search index" titleHelp={<DocumentationHelpLink
+            reference={DOCUMENTATION}
+            label="Open Search administration documentation"
+          />}
       description="Inspect source coverage, process durable changes, and reconcile the tenant's derived index from authoritative modules."
       loading={loading}
       error={error}
@@ -225,10 +228,7 @@ export default function SearchAdminPanel({ settings }: Props) {
           >
             <RotateCw size={16} /> Reconcile modules
           </Button>
-          <DocumentationHelpLink
-            reference={DOCUMENTATION}
-            label="Open Search administration documentation"
-          />
+
         </>
       )}
     >
diff --git a/webui/src/features/search/SearchPage.tsx b/webui/src/features/search/SearchPage.tsx
index e779349..d14acbd 100644
--- a/webui/src/features/search/SearchPage.tsx
+++ b/webui/src/features/search/SearchPage.tsx
@@ -1,7 +1,7 @@
 import { ChevronDown, ExternalLink, Search } from "lucide-react";
 import { useEffect, useMemo, useState, type FormEvent } from "react";
 import { useSearchParams } from "react-router";
-import { ActionToolbar, Button, DocumentationHelpLink, DismissibleAlert, LoadingIndicator,
+import { ActionToolbar, Button, DocumentationHelpLink, DismissibleAlert, LoadingIndicator, PageTitle,
   PageScrollViewport, useGuardedNavigate, usePlatformModules, type PlatformRouteContext
 } from "@govoplan/core-webui";
 import SearchFilters from "../../components/SearchFilters";
@@ -43,6 +43,10 @@ export default function SearchPage({ settings, auth }: PlatformRouteContext) {
   return (
     <main className="search-page">
       <ActionToolbar className="search-page-toolbar">
+        <PageTitle titleHelp={<DocumentationHelpLink
+          reference={{ topicId: "search.global-and-contextual", documentationType: "user" }}
+          label="Open search documentation"
+        />}>Search</PageTitle>
         <form className="search-page-form" onSubmit={submit}>
           <Search size={18} aria-hidden="true" />
           <input
@@ -59,10 +63,6 @@ export default function SearchPage({ settings, auth }: PlatformRouteContext) {
           onResourceTypesChange={(value) => setParams(writeSearchFilter(params, "resource_type", value))}
           onClear={clearFilters} />
         {loading && <LoadingIndicator size="sm" label="Searching" />}
-        <DocumentationHelpLink
-          reference={{ topicId: "search.global-and-contextual", documentationType: "user" }}
-          label="Open search documentation"
-        />
       </ActionToolbar>
       <PageScrollViewport className="search-results-viewport">
         {error &&