From bad3418a7ce950151f05d4db70d99cc46c1e33d0 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_projects/backend/manifest.py    |  5 +++++
 webui/src/features/projects/ProjectsPage.tsx |  6 ++++--
 webui/src/i18n/generatedTranslations.ts      | 12 ++++++++++++
 webui/src/module.ts                          |  2 ++
 webui/src/styles/projects.css                |  2 +-
 5 files changed, 24 insertions(+), 3 deletions(-)
 create mode 100755 webui/src/i18n/generatedTranslations.ts

diff --git a/src/govoplan_projects/backend/manifest.py b/src/govoplan_projects/backend/manifest.py
index b44a9d0..89f3d43 100644
--- a/src/govoplan_projects/backend/manifest.py
+++ b/src/govoplan_projects/backend/manifest.py
@@ -216,6 +216,8 @@ DOCUMENTATION = (
             "capacity assumptions, outcomes, and benefit reviews without absorbing work-item ownership."
         ),
         body=(
+            "Documentation books sit immediately beside the visible heading or contextual label for "
+            "Projects, not among operational action buttons. Field help remains beside its label. "
             "Projects owns native portfolio and project context, immutable revisions of goals and intended outcomes, "
             "milestones, participants, status, dependencies, capacity assumptions, benefit reviews, and governed resource references. "
             "Create or revise the planning context, review its impact, and link provider-owned work and evidence without copying it. "
@@ -291,6 +293,9 @@ DOCUMENTATION = (
                     "Ergebnisse und Nutzenprüfungen koordinieren, ohne die Eigentümerschaft an Arbeitselementen zu übernehmen."
                 ),
                 "body": (
+                    "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                    "Kontextbezeichnung für Projekte, nicht zwischen ausführbaren Aktionsschaltflächen. Feldhilfe "
+                    "bleibt neben der Feldbezeichnung. "
                     "Projects führt den nativen Portfolio- und Projektkontext, unveränderliche Revisionen von Zielen und "
                     "beabsichtigten Ergebnissen, Meilensteine, Beteiligte, Status, Abhängigkeiten, Kapazitätsannahmen, "
                     "Nutzenprüfungen und gesteuerte Ressourcenreferenzen. Planungskontext wird angelegt oder revidiert, "
diff --git a/webui/src/features/projects/ProjectsPage.tsx b/webui/src/features/projects/ProjectsPage.tsx
index 7f0b754..6e70c68 100644
--- a/webui/src/features/projects/ProjectsPage.tsx
+++ b/webui/src/features/projects/ProjectsPage.tsx
@@ -241,7 +241,9 @@ export default function ProjectsPage({ settings, auth }: PlatformRouteContext) {
             </label>
             <span className="projects-count">{total} objects</span>
           </>}
-          helpAction={<DocumentationHelpLink
+          title="Projects"
+          titleLevel={1}
+          titleHelp={<DocumentationHelpLink
             reference={{ topicId: "projects.module-boundary", documentationType: "user" }}
             label="Open Projects documentation"
           />}
@@ -309,7 +311,7 @@ function ProjectDetail({ record, canWrite, onEdit }: {
       <header className="project-detail-header">
         <div>
           <span className="project-eyebrow">{humanize(record.object_kind)} · {record.object_key}</span>
-          <h1>{record.title}</h1>
+          <h2>{record.title}</h2>
         </div>
         <div className="project-detail-actions">
           <StatusBadge status={statusTone(record.state)} label={humanize(record.state)} />
diff --git a/webui/src/i18n/generatedTranslations.ts b/webui/src/i18n/generatedTranslations.ts
new file mode 100755
index 0000000..006afd3
--- /dev/null
+++ b/webui/src/i18n/generatedTranslations.ts
@@ -0,0 +1,12 @@
+import type { PlatformTranslations } from "@govoplan/core-webui";
+
+/** Module-owned translations for contextual headings. */
+export const generatedTranslations: PlatformTranslations = {
+  en: {
+    "Projects": "Projects",
+  },
+  de: {
+    "Projects": "Projekte",
+  },
+};
+
diff --git a/webui/src/module.ts b/webui/src/module.ts
index 766f58a..baf4882 100644
--- a/webui/src/module.ts
+++ b/webui/src/module.ts
@@ -1,11 +1,13 @@
 import { createElement, lazy } from "react";
 import type { PlatformWebModule } from "@govoplan/core-webui";
+import { generatedTranslations } from "./i18n/generatedTranslations";
 import "./styles/projects.css";
 
 
 const ProjectsPage = lazy(() => import("./features/projects/ProjectsPage"));
 
 export const projectsModule: PlatformWebModule = {
+  translations: generatedTranslations,
   id: "projects",
   label: "Projects",
   version: "0.1.14",
diff --git a/webui/src/styles/projects.css b/webui/src/styles/projects.css
index 74f1f9e..4573974 100644
--- a/webui/src/styles/projects.css
+++ b/webui/src/styles/projects.css
@@ -62,7 +62,7 @@
   border-bottom: 1px solid var(--border);
 }
 
-.project-detail-header h1 {
+.project-detail-header h2 {
   margin: 4px 0 0;
   font-size: 1.4rem;
   letter-spacing: 0;