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.

webui/scripts/test-interface-pattern-language.mjs

@@ -41,7 +41,7 @@ assert.match(openFolderNode, /setSelectedFolderGroup\(\{ id: node\.id, label: no
 assert.match(openFolderNode, /messageDetailRequestRef\.current \+= 1/, "Selecting a grouping invalidates pending message detail.");
 assert.match(mailbox, /selectedFolderGroup\?\.id \?\? findFolderNodeId/);
 assert.match(mailbox, /<WorkspaceFrame[^>]*height="viewport"/);
-assert.match(mailbox, /<WorkspaceActionBar\s+variant="workspace"\s+scope="workspace"[\s\S]*refreshable[\s\S]*onReload: \(\) => void reloadMailbox\(\)/);
+assert.match(mailbox, /<WorkspaceActionBar\s+title="i18n:govoplan-mail\.mailbox_workspace"\s+titleHelp=\{<DocumentationHelpLink reference=\{MAILBOX_DOCUMENTATION\} \/>\}\s+variant="workspace"\s+scope="workspace"[\s\S]*refreshable[\s\S]*onReload: \(\) => void reloadMailbox\(\)/);
 assert.ok(mailbox.indexOf("<WorkspaceActionBar") < mailbox.indexOf('<aside className="file-tree-panel"'), "Mailbox actions remain outside all selectable panes.");
 assert.equal((mailbox.match(/<WorkspaceActionBar/g) ?? []).length, 1, "One persistent page-wide action bar.");
 assert.doesNotMatch(mailbox, /mailbox-toolbar|<ToolbarGroup/);

webui/src/features/mail/MailBouncePage.tsx

@@ -196,13 +196,13 @@ export default function MailBouncePage({ settings }: { settings: ApiSettings })
       <PageLayout
         archetype="collection"
         title="Bounce processing"
+        titleHelp={<DocumentationHelpLink reference={MAIL_BOUNCE_DOCUMENTATION} />}
         description="Watch IMAP delivery-status folders and correlate recipient failures with Mail delivery commands."
         actions={<PageActionBar
           variant="collection"
           refreshable
           reloadAction={{ onReload: () => void load(), disabled: Boolean(pageMutationBlocker), disabledReason: pageMutationBlocker }}
           contextActions={<Button onClick={() => navigate("/mail")}><ArrowLeft size={16} aria-hidden="true" /> Mailbox</Button>}
-          helpAction={<DocumentationHelpLink reference={MAIL_BOUNCE_DOCUMENTATION} />}
           createAction={<Button variant="primary" onClick={() => setAddOpen(true)} disabled={Boolean(addWatcherBlocker)} disabledReason={addWatcherBlocker}><Plus size={16} aria-hidden="true" /> Add watcher</Button>}
         />}
         loading={loading}

webui/src/features/mail/MailLegacyImportPage.tsx

@@ -379,6 +379,7 @@ export default function MailLegacyImportPage({
       <PageLayout
         archetype="collection"
         title="Legacy POP3 import"
+        titleHelp={<DocumentationHelpLink reference={DOCUMENTATION} />}
         description="Migrate bounded messages into encrypted local review records. POP3 is disabled by default and is not recommended for ongoing mailbox access."
         helpContextId="mail.pop3"
         helpModuleId="mail"
@@ -388,7 +389,6 @@ export default function MailLegacyImportPage({
           refreshable
           reloadAction={{ onReload: () => void load(), helpContextId: "mail.pop3.action.reload", helpModuleId: "mail", helpTopicId: "mail.workflow.legacy-pop3-import", disabled: Boolean(busy), disabledReason: busy ? "Wait for the current POP3 action to finish." : undefined }}
           contextActions={<Button onClick={() => navigate("/mail")}><ArrowLeft size={16} aria-hidden="true" /> Mailbox</Button>}
-          helpAction={<DocumentationHelpLink reference={DOCUMENTATION} />}
           createAction={canManage ? <Button helpContextId="mail.pop3.action.create-source" helpModuleId="mail" helpTopicId="mail.workflow.legacy-pop3-import" variant="primary" onClick={() => openSourceDialog(null)} disabled={Boolean(busy) || configurableProfiles.length === 0} disabledReason={configurableProfiles.length === 0 ? "Create or gain write access to a Mail profile first." : undefined}><Plus size={16} aria-hidden="true" /> Add legacy source</Button> : undefined}
         />}
         loading={loading}

webui/src/features/mail/MailProfileManagement.tsx

@@ -630,9 +630,9 @@ export function MailProfileScopeManager({
       <>
           <Card
           title={profileTitle}
+            titleHelp={<DocumentationHelpLink reference={MAIL_PROFILE_DOCUMENTATION} />}
           actions={
           <div className="button-row compact-actions">
-                <DocumentationHelpLink reference={MAIL_PROFILE_DOCUMENTATION} />
                 <Button onClick={() => void loadProfiles()} disabled={Boolean(profileReloadBlocker)} disabledReason={profileReloadBlocker}>{loading ? "i18n:govoplan-mail.loading.33ce4174" : "i18n:govoplan-mail.reload.cce71553"}</Button>
                 <Button variant="primary" onClick={openCreate} disabled={Boolean(profileMutationBlocker)} disabledReason={profileMutationBlocker}><Plus size={16} />i18n:govoplan-mail.new_profile.ca36da25</Button>
               </div>

webui/src/features/mail/MailProfilePolicyEditor.tsx

@@ -224,9 +224,9 @@ export function MailProfilePolicyEditor({
   return (
     <Card
       title={title}
+      titleHelp={<DocumentationHelpLink reference={MAIL_PROFILE_DOCUMENTATION} />}
       actions={
       <div className="button-row compact-actions">
-          <DocumentationHelpLink reference={MAIL_PROFILE_DOCUMENTATION} />
           <Button onClick={() => void loadPolicy()} disabled={loading || busy || !scopeReady} disabledReason={loading ? "Mail policy is already loading." : busy ? "Wait for the current policy change to finish." : !scopeReady ? "Select a policy target before reloading." : undefined}>{loading ? "i18n:govoplan-mail.loading.33ce4174" : "i18n:govoplan-mail.reload.cce71553"}</Button>
           <Button variant="primary" onClick={() => void savePolicy()} disabled={Boolean(policySaveBlocker)} disabledReason={policySaveBlocker}>{busy ? "i18n:govoplan-mail.saving.56a2285c" : "i18n:govoplan-mail.save_policy.77d67ce3"}</Button>
         </div>

webui/src/features/mail/MailboxPage.tsx

@@ -626,6 +626,8 @@ export default function MailboxPage({ settings, auth }: { settings: ApiSettings;
       {error && <DismissibleAlert tone="danger" resetKey={error} floating>{error}</DismissibleAlert>}
 
       <WorkspaceActionBar
+        title="i18n:govoplan-mail.mailbox_workspace"
+        titleHelp={<DocumentationHelpLink reference={MAILBOX_DOCUMENTATION} />}
         variant="workspace"
         scope="workspace"
         label="i18n:govoplan-mail.mail_actions.c08b5f08"
@@ -647,7 +649,6 @@ export default function MailboxPage({ settings, auth }: { settings: ApiSettings;
           </FormField>
           <Button type="button" onClick={() => setMailToolsOpen(true)} helpContextId="mail.mailbox.tools" helpModuleId="mail" helpTopicId="mail.workflow.read-mailbox">i18n:govoplan-mail.mailbox_tools</Button>
         </>}
-        helpAction={<DocumentationHelpLink reference={MAILBOX_DOCUMENTATION} />}
       />
 
       <div className={`file-manager-shell mailbox-shell ${shellBusy ? "is-loading" : ""}`}>