Skip to content

Commit 0eb8b1b

Browse files
committed
docs(permissions): reword 'give people a role' to position language (role-word guard)
ADR-0090 D3 reserves the word 'role'; the check:role-word CI guard flagged three new uses. Step 3 is now 'Assign positions' (heading, flow list, and quick-paths anchor updated to match). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DPYFwzYSsKjU12xSJtbAyB
1 parent ea82cc0 commit 0eb8b1b

1 file changed

Lines changed: 3 additions & 3 deletions

File tree

content/docs/permissions/administrator-guide.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Onboarding a tenant is four ordered steps — each depends on the previous one:
4040

4141
1. **Build the organization** — create the business-unit tree.
4242
2. **Add people** — invite, create, or import users; place them in units.
43-
3. **Give people a role**assign positions (the daily 90%).
43+
3. **Assign positions**give each person their job function (the daily 90%).
4444
4. **Verify** — impersonate a user and ask the explain engine why access
4545
resolves the way it does.
4646

@@ -97,7 +97,7 @@ through this membership, so don't skip it.
9797
Endpoint-level detail (payloads, password policies, phone-only accounts):
9898
[Authentication → Admin User Management](/docs/permissions/authentication#admin-user-management).
9999

100-
## Step 3 — Give people a role (assign positions)
100+
## Step 3 — Assign positions
101101

102102
This is the daily 90%. An assignment is one row: **User Position**
103103
(`sys_user_position`) = *user* + *position* + optionally the **business unit**
@@ -170,7 +170,7 @@ Full model: [Permission Sets](/docs/permissions/permission-sets).
170170

171171
| I need to… | Do this |
172172
|:--|:--|
173-
| Onboard a new employee | Invite/Create the user → Business Unit Member row → assign their position ([2](#step-2--add-people-users)[3](#step-3--give-people-a-role-assign-positions)) |
173+
| Onboard a new employee | Invite/Create the user → Business Unit Member row → assign their position ([2](#step-2--add-people-users)[3](#step-3--assign-positions)) |
174174
| Offboard someone | **Ban User** (blocks sign-in immediately) — then remove assignments at leisure |
175175
| "I can't sign in" | User record → is it banned? locked? **Unlock Account** or **Set Password** (temporary, must-change) |
176176
| "Why can't I see X?" | Studio → Access → **Explain access** for that user + object |

0 commit comments

Comments
 (0)