Skip to content

docs(approvals): name delegated_admin in the org-membership tier vocabulary #152

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-zhuang merged 1 commit into from
Aug 22, 2026
Merged

docs(approvals): name delegated_admin in the org-membership tier vocabulary #152

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions content/docs/build/automation/approvals.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ Each entry in `approvers` names a `type` and a `value`:
| `team` | Members of a flat collaboration team |
| `field` | The user id held in a field on the triggering record |
| `user` | One named user id |
| `org_membership_level` | An org-membership tier (`owner` / `admin` / `member`) |
| `org_membership_level` | An org-membership tier (`owner` / `admin` / `delegated_admin` / `member`) |
| `expression` | A CEL expression resolved at node entry — see below |

Prefer the indirect bindings (`manager`, `position`, `department`,
Expand All @@ -85,12 +85,12 @@ should no longer see them.
> **Warning — `position` vs the membership tier.**
> `{ type: 'position', value: 'finance_manager' }` routes to the holders of a
> position (`sys_user_position`). The org-membership tier (`sys_member.role`:
> `owner`/`admin`/`member`) is addressed as `type: 'org_membership_level'`
> since 16.0; the old spelling `role` is a **deprecated alias for one
> release** — it still loads and resolves identically, with a warning, and is
> removed in the next major. A position name authored as the membership-tier
> type matches nobody and the request stalls. `os lint` flags both cases
> (`approval-approver-not-membership-tier`,
> `owner`/`admin`/`delegated_admin`/`member`) is addressed as
> `type: 'org_membership_level'` since 16.0; the old spelling `role` is a
> **deprecated alias for one release** — it still loads and resolves
> identically, with a warning, and is removed in the next major. A position name
> authored as the membership-tier type matches nobody and the request stalls.
> `os lint` flags both cases (`approval-approver-not-membership-tier`,
> `approval-approver-type-deprecated`); if the value names an org position,
> the fix is `type: 'position'`.

Expand Down