From f50e1b9d842a796ed4ecb01300f008212d7c970e Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 9 Sep 2026 02:04:04 +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_records/backend/manifest.py   | 5 +++++
 webui/src/features/records/RecordsPage.tsx | 6 ++++--
 webui/src/styles/records.css               | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/src/govoplan_records/backend/manifest.py b/src/govoplan_records/backend/manifest.py
index 3f0c4bc..d1ee560 100644
--- a/src/govoplan_records/backend/manifest.py
+++ b/src/govoplan_records/backend/manifest.py
@@ -264,6 +264,8 @@ DOCUMENTATION = (
         title="eAkte workspace",
         summary="Create and browse institutional records, their exact filed items, and chronology.",
         body=(
+            "Documentation books sit immediately beside the visible heading or contextual label for "
+            "Records, not among operational action buttons. Field help remains beside its label. "
             "Records owns the stable record identity, file-plan classification, immutable revisions, "
             "volumes, filing decisions, and chronology. Files and other source modules continue to own "
             "their content. Filing resolves and preserves an exact source revision only after the source "
@@ -290,6 +292,9 @@ DOCUMENTATION = (
                 "title": "eAkte-Arbeitsbereich",
                 "summary": "Institutionelle Akten, exakt veraktete Objekte und die Chronologie anlegen und einsehen.",
                 "body": (
+                    "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                    "Kontextbezeichnung für Akten, nicht zwischen ausführbaren Aktionsschaltflächen. Feldhilfe "
+                    "bleibt neben der Feldbezeichnung. "
                     "Records verwaltet die stabile Aktenidentität, Aktenplanklassifikation, unveränderliche "
                     "Revisionen, Bände, Veraktungsentscheidungen und die Chronologie. Dateien und andere "
                     "Quellmodule bleiben Eigentümer ihrer Inhalte. Bei der Veraktung wird erst nach aktueller "
diff --git a/webui/src/features/records/RecordsPage.tsx b/webui/src/features/records/RecordsPage.tsx
index 5682b2f..23ec477 100644
--- a/webui/src/features/records/RecordsPage.tsx
+++ b/webui/src/features/records/RecordsPage.tsx
@@ -296,7 +296,9 @@ export default function RecordsPage({ settings, auth }: PlatformRouteContext) {
             />
             )}
           </>}
-          helpAction={<DocumentationHelpLink reference={RECORDS_DOCUMENTATION} />}
+          title="Records"
+          titleLevel={1}
+          titleHelp={<DocumentationHelpLink reference={RECORDS_DOCUMENTATION} />}
         />
 
         {error && <DismissibleAlert tone="danger" resetKey={error}>{error}</DismissibleAlert>}
@@ -508,7 +510,7 @@ function RecordDetailPanel({
       <div className="records-detail-header">
         <div>
           <span className="records-eyebrow">{record.record_number}</span>
-          <h1>{record.title}</h1>
+          <h2>{record.title}</h2>
         </div>
         <div className="records-detail-actions">
           {record.access_mode === "restricted" && canAdmin && (
diff --git a/webui/src/styles/records.css b/webui/src/styles/records.css
index d727fa3..3b7a955 100644
--- a/webui/src/styles/records.css
+++ b/webui/src/styles/records.css
@@ -194,7 +194,7 @@
   border-bottom: var(--border-line-dark);
 }
 
-.records-detail-header h1 {
+.records-detail-header h2 {
   margin: 3px 0 0;
   font-size: 1.35rem;
   letter-spacing: 0;