fix(ui): move widget and page documentation into 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.

webui/scripts/test-scheduling-page-structure.mjs

@@ -201,7 +201,8 @@ assert.match(enrollmentPage, /topicId: "scheduling\.public-self-enrollment"/);
 assert.doesNotMatch(enrollmentPage, /window\.(?:alert|confirm)\(/);
 assert.doesNotMatch(enrollmentPage, /(?:localStorage|sessionStorage).*(?:token|proof)|(?:token|proof).*(?:localStorage|sessionStorage)/);
 
-assert.match(widget, /DocumentationHelpLink/);
+assert.doesNotMatch(widget, /DocumentationHelpLink/, "widget help belongs to the host card title, not a detached footer");
+assert.match(moduleSource, /documentation: \{ topicId: "scheduling\.find-and-decide-meeting-time", documentationType: "user" \}/);
 assert.match(widget, /to: `\/scheduling\?request_id=\$\{encodeURIComponent\(request\.id\)\}`/);
 assert.match(widget, /label=\{request\.status === "collecting" \? I18N\.open : I18N\.draft\}/);
 assert.doesNotMatch(widget, /Loading scheduling requests|Open scheduling|No scheduling requests are awaiting responses/);

webui/src/features/scheduling/SchedulingEnrollmentPage.tsx

@@ -202,11 +202,11 @@ export default function SchedulingEnrollmentPage({ settings, auth }: SchedulingE
         {enrollment ? (
           <form className="scheduling-public-content" onSubmit={submit}>
             <Card
-              title={enrollment.title}
-              actions={<DocumentationHelpLink reference={{
+              title={enrollment.title} titleHelp={<DocumentationHelpLink reference={{
                 topicId: "scheduling.public-self-enrollment",
                 documentationType: "user"
-              }} />}>
+              }} />}
+              >
               {enrollment.description ? <p>{enrollment.description}</p> : null}
               <dl className="scheduling-public-summary">
                 {enrollment.deadline_at ? <><dt>{I18N.deadline}</dt><dd>{formatDateTime(enrollment.deadline_at)}</dd></> : null}

webui/src/features/scheduling/SchedulingPage.tsx

@@ -27,7 +27,7 @@ import { ContentGrid, FormGrid,
   DocumentationHelpLink,
   FormField,
   MetricCard,
-  PageTitle,
+  TextWithHelp,
   PasswordField,
   PeoplePicker,
   formatDateTime,
@@ -939,7 +939,9 @@ export default function SchedulingPage({ settings, auth }: { settings: ApiSettin
           variant="collection"
           refreshable
           reloadAction={{ onReload: () => void loadRequests(selected?.id), loading: loading || saving, disabledReason: saving ? I18N.saving : undefined, label: I18N.refresh }}
-          helpAction={<DocumentationHelpLink reference={{ topicId: "scheduling.find-and-decide-meeting-time", documentationType: "user" }} />}
+          title="Scheduling"
+          titleLevel={1}
+          titleHelp={<DocumentationHelpLink reference={{ topicId: "scheduling.find-and-decide-meeting-time", documentationType: "user" }} />}
           createAction={<Button type="button" variant="primary" onClick={beginCreate} disabled={!canCreateOrWrite || saving} disabledReason={saving ? I18N.saving : !canCreateOrWrite ? I18N.createPermissionRequired : undefined}><Plus aria-hidden="true" size={16} /> {I18N.newRequest}</Button>}
         />
         <div className="scheduling-workspace-layout">
@@ -985,15 +987,12 @@ export default function SchedulingPage({ settings, auth }: { settings: ApiSettin
                   contextActions={<div className="scheduling-page-title">
                     <CalendarCheck aria-hidden="true" size={20} />
                     <div>
-                      <PageTitle>{editorMode === "create" ? I18N.newRequest : I18N.edit}</PageTitle>
+                      <TextWithHelp as="div" help={<DocumentationHelpLink
+                        reference={{ topicId: "scheduling.find-and-decide-meeting-time", documentationType: "user" }}
+                      />}><h2>{editorMode === "create" ? I18N.newRequest : I18N.edit}</h2></TextWithHelp>
                       <p>{editorMode === "create" ? I18N.addRequest : title}</p>
                     </div>
                   </div>}
-                  helpAction={<DocumentationHelpLink
-                      reference={{
-                        topicId: "scheduling.find-and-decide-meeting-time",
-                        documentationType: "user"
-                      }} />}
                   discardAction={{ label: I18N.discard, type: "button", onClick: discardEditor }}
                   saveAction={{
                       label: <><Save aria-hidden="true" size={16} /> {saving ? I18N.saving : I18N.save}</>,
@@ -1171,14 +1170,14 @@ export default function SchedulingPage({ settings, auth }: { settings: ApiSettin
                     statusLabel: stage.current ? requestStatusLabel(selected, actor) : undefined
                   }))} />
                 <Card
-                  title={selected.title}
-                  actions={(
-                    <div className="scheduling-actions">
-                      <DocumentationHelpLink
+                  title={selected.title} titleHelp={<DocumentationHelpLink
                         reference={{
                           topicId: "scheduling.find-and-decide-meeting-time",
                           documentationType: "user"
-                        }} />
+                        }} />}
+                  actions={(
+                    <div className="scheduling-actions">
+
                       {canEditSelected ? (
                         <Button
                           type="button"
@@ -2394,11 +2393,11 @@ function SelfEnrollmentLinksCard({
 
   return (
     <Card
-      title={I18N.selfEnrollmentLinks}
-      actions={<DocumentationHelpLink reference={{
+      title={I18N.selfEnrollmentLinks} titleHelp={<DocumentationHelpLink reference={{
         topicId: "scheduling.public-self-enrollment",
         documentationType: "user"
-      }} />}>
+      }} />}
+      >
       <p className="scheduling-capability-note">
         {I18N.selfEnrollmentLinksHelp}
       </p>

webui/src/features/scheduling/SchedulingPublicPage.tsx

@@ -170,14 +170,12 @@ export default function SchedulingPublicPage({ settings, auth }: SchedulingPubli
 
         {!response && !loading && (
           <Card
-            title={I18N.accessDetails}
-            actions={(
-              <DocumentationHelpLink
+            title={I18N.accessDetails} titleHelp={<DocumentationHelpLink
                 reference={{
                   topicId: "scheduling.find-and-decide-meeting-time",
                   documentationType: "user"
-                }} />
-            )}>
+                }} />}
+            >
             <form className="scheduling-public-access-form" onSubmit={openRequest}>
               <p className="muted">{I18N.accessHelp}</p>
               {accessAttempted && error && <DismissibleAlert tone="danger">{error}</DismissibleAlert>}
@@ -213,14 +211,12 @@ export default function SchedulingPublicPage({ settings, auth }: SchedulingPubli
         {response && (
           <form className="scheduling-public-content" onSubmit={saveResponse}>
             <Card
-              title={response.title}
-              actions={(
-                <DocumentationHelpLink
+              title={response.title} titleHelp={<DocumentationHelpLink
                   reference={{
                     topicId: "scheduling.find-and-decide-meeting-time",
                     documentationType: "user"
-                  }} />
-              )}>
+                  }} />}
+              >
               {response.description && <p className="scheduling-public-description">{response.description}</p>}
               <dl className="scheduling-public-summary">
                 {response.location && <><dt>i18n:govoplan-scheduling.location.d219c681</dt><dd>{response.location}</dd></>}

webui/src/features/scheduling/SchedulingRequestsWidget.tsx

@@ -4,7 +4,6 @@ import { Link } from "react-router";
 import {
   DashboardWidgetList,
   DismissibleAlert,
-  DocumentationHelpLink,
   LoadingFrame,
   StatusBadge,
   formatDateTime,
@@ -80,11 +79,6 @@ export default function SchedulingRequestsWidget({
         }))}
       />
       <div className="dashboard-contribution-footer">
-        <DocumentationHelpLink
-          reference={{
-            topicId: "scheduling.find-and-decide-meeting-time",
-            documentationType: "user"
-          }} />
         <Link className="btn btn-secondary" to="/scheduling">
           {I18N.openScheduling}
         </Link>

webui/src/i18n/generatedTranslations.ts

@@ -1,5 +1,6 @@
 export const generatedTranslations = {
   en: {
+    "Scheduling": "Scheduling",
     "i18n:govoplan-scheduling.self_enrollment.access": "Open self-enrollment",
     "i18n:govoplan-scheduling.self_enrollment.bind_account": "Bind this enrollment to my signed-in account",
     "i18n:govoplan-scheduling.self_enrollment.bind_help": "Account binding requires confirmation and lets you manage this response from Scheduling.",
@@ -219,6 +220,7 @@ export const generatedTranslations = {
     "i18n:govoplan-scheduling.your_response_has_been_recorded.b855088d": "Your response has been recorded."
   },
   de: {
+    "Scheduling": "Terminplanung",
     "i18n:govoplan-scheduling.self_enrollment.access": "Selbstanmeldung öffnen",
     "i18n:govoplan-scheduling.self_enrollment.bind_account": "Diese Anmeldung mit meinem angemeldeten Konto verknüpfen",
     "i18n:govoplan-scheduling.self_enrollment.bind_help": "Die Kontoverknüpfung muss bestätigt werden und ermöglicht die Verwaltung dieser Antwort in der Terminplanung.",

webui/src/module.ts

@@ -18,6 +18,7 @@ const schedulingDashboardWidgets: DashboardWidgetsUiCapability = {
       id: "scheduling.open-requests",
       surfaceId: "scheduling.widget.open-requests",
       title: "Scheduling requests",
+      documentation: { topicId: "scheduling.find-and-decide-meeting-time", documentationType: "user" },
       description: "Open scheduling polls and their response progress.",
       moduleId: "scheduling",
       category: "Planning",

webui/src/styles/scheduling.css

@@ -182,7 +182,7 @@
   min-width: 0;
 }
 
-.scheduling-page-title h1 {
+.scheduling-page-title h2 {
   margin: 0;
   color: var(--text-strong);
   font-size: 19px;