@@ -35,8 +35,9 @@ export const positionForm = defineForm({
         // #19331 — `delegatable` is declared by PositionSchema and was offered by
         // no control, so the only door to an ADR-0091 D3 self-service delegation
         // was the Source tab's free-text JSON. A boolean node takes the boolean
-        // control; the copy states the gate the runtime actually applies.
-        { field: 'delegatable', type: 'boolean', colSpan: 1, helpText: 'Holders may delegate this position themselves, time-boxed and with a reason (ADR-0091 D3). Default false — delegation is admin-only.' },
+        // control; the copy states the gate the runtime actually applies. The
+        // decision record (ADR-0091 D3) stays in this comment, out of the help text.
+        { field: 'delegatable', type: 'boolean', colSpan: 1, helpText: 'Holders may delegate this position themselves, time-boxed and with a reason. Default false — delegation is admin-only.' },
       ],
     },
   ],
 
@@ -35,15 +35,26 @@ export const permissionForm = defineForm({
         // #19331 — four declared keys had no control, so the only door to any of
         // them was the Source tab's free-text JSON. `description` is persisted on
         // sys_permission_set and shown in Setup; the other three are the ADR-0086
-        // D3 provenance pair plus the ADR-0090 D5 baseline flag.
+        // D3 provenance pair plus the ADR-0090 D5 baseline flag. The help texts
+        // are an admin's words; the decision records stay here:
+        //  - `isDefault` (ADR-0090 D5): an app-level set is auto-bound to the
+        //    built-in `everyone` position at boot, after the high-privilege check;
+        //    a package-level set materializes a `sys_audience_binding_suggestion`
+        //    an admin confirms in Setup.
+        //  - `managedBy` (ADR-0086 D3): `package` rows are re-seeded on upgrade;
+        //    `platform` / `user` rows are environment config package seeding
+        //    never touches.
+        //  - `packageId` (ADR-0086 D3): a value that disagrees with the package
+        //    the set ships in or is saved into is refused
+        //    (`judgePermissionSetOwnerBinding`).
         { field: 'description', type: 'textarea', colSpan: 2, helpText: 'Human-readable description shown in Setup.' },
-        { field: 'isDefault', type: 'boolean', colSpan: 1, helpText: 'App baseline for the everyone position (ADR-0090 D5): an app-level set is auto-bound at boot; a package-level set becomes an install-time suggestion an admin confirms. Default false.' },
-        { field: 'managedBy', type: 'select', colSpan: 1, helpText: 'Record provenance (ADR-0086 D3): who owns this set across upgrades.', options: [
+        { field: 'isDefault', type: 'boolean', colSpan: 1, helpText: 'Gives this set to everyone who signs in, through the built-in everyone position. A set the app itself declares is granted at startup; a set from an installed package becomes a suggestion an admin confirms in Setup. A set with high-privilege permissions is never granted this way. Default false.' },
+        { field: 'managedBy', type: 'select', colSpan: 1, helpText: 'Who owns this set: Package means it ships with a package and package upgrades update it; Platform and User mean it was created in this environment and upgrades leave it alone.', options: [
           { label: 'Package (upgrade-owned metadata)', value: 'package' },
           { label: 'Platform (environment config)', value: 'platform' },
           { label: 'User (environment config)', value: 'user' },
         ] },
-        { field: 'packageId', type: 'text', colSpan: 2, helpText: 'Owning package id for a package-shipped set (ADR-0086 D3). Leave empty for an environment-authored set.' },
+        { field: 'packageId', type: 'text', colSpan: 2, helpText: 'The package that ships this set; a value naming any other package is refused. Leave empty for a set created in this environment.' },
       ],
     },
     {
@@ -61,7 +72,7 @@ export const permissionForm = defineForm({
         // touch is rewritten. #23488: the help text names the scope's four
         // live keys only; `manageBindings` and `authorEnvironmentSets` are
         // retired tombstones, not rights a set can grant.
-        { field: 'adminScope', widget: 'json', helpText: 'Delegated administration (ADR-0090 D12): lets holders of this set administer one business-unit subtree. businessUnit is the subtree root (sys_business_unit.name) and is required, non-blank; includeSubtree defaults to true; manageAssignments defaults to false and lets the holder assign people to positions, and grant sets directly, inside that subtree; a delegate may hand out only the sets named in assignablePermissionSets. Leave empty for a set that delegates nothing.' },
+        { field: 'adminScope', widget: 'json', helpText: 'Delegated administration: lets holders of this set administer one business-unit subtree. businessUnit is the subtree root (sys_business_unit.name) and is required, non-blank; includeSubtree defaults to true; manageAssignments defaults to false and lets the holder assign people to positions, and grant sets directly, inside that subtree; a delegate may hand out only the sets named in assignablePermissionSets. Leave empty for a set that delegates nothing.' },
       ],
     },
     {
 
@@ -158,10 +158,12 @@ export const viewForm = defineForm({
     // `ListViewSchema` — a form input for an unwritable key is the false-compliant
     // UI half of a retirement. To put a published page in front of users, author
     // an app navigation item instead.
+    // The end-user controls are ADR-0047's Airtable Interface parity surface;
+    // the record stays in this comment, out of the section description.
     {
       name: 'end_user_controls',
       label: 'End-user controls',
-      description: 'What end users can do on this view — quick filters, filter tabs, visualization switching (ADR-0047, Airtable Interface parity).',
+      description: 'What end users can do on this view — quick filters, filter tabs, visualization switching.',
       collapsible: true,
       collapsed: true,
       fields: [