Add section on custom roles to users guide

Introduce a new section detailing the availability and configuration of custom roles in Coder's premium edition. This aligns with the release of Coder v2.16+ and highlights that custom roles can be set at the organization level, requiring a premium license.
coder · stirby · Oct 1, 2024 · Sep 24, 2024 · Sep 24, 2024 · Sep 24, 2024
commit 67ce5d4a85f44981efcbe32a4c5e191773d29b1c
diff --git a/docs/admin/users.md b/docs/admin/users.md
@@ -10,7 +10,7 @@ Coder offers these user roles in the community edition:
 |                                                       | Auditor | User Admin | Template Admin | Owner |
 | ----------------------------------------------------- | ------- | ---------- | -------------- | ----- |
 | Add and remove Users                                  |         | ✅         |                | ✅    |
-| Manage groups (premium )                              |         | ✅         |                | ✅    |
+| Manage groups (premium)                               |         | ✅         |                | ✅    |
 | Change User roles                                     |         |            |                | ✅    |
 | Manage **ALL** Templates                              |         |            | ✅             | ✅    |
 | View **ALL** Workspaces                               |         |            | ✅             | ✅    |
@@ -22,6 +22,16 @@ Coder offers these user roles in the community edition:
 A user may have one or more roles. All users have an implicit Member role that
 may use personal workspaces.
 
+## Custom Roles (Premium) (Beta)
+
+Coder v2.16+ deployments can configure custom roles on the
+[Organization](./organizations.md) level.
+
+![Custom roles](../images/admin/organizations/custom-roles.png)
+
+> Note: This requires a Premium license.
+> [Contact your account team](https://coder.com/contact) for more details.
+
 ## Security notes
 
 A malicious Template Admin could write a template that executes commands on the

diff --git a/docs/images/admin/organizations/custom-roles.png b/docs/images/admin/organizations/custom-roles.png