docs: document additional roles (#3496)

ammario · Emyrk · web-flow · commit 8cf82112ad76 · 2022-08-12T22:42:16.000Z
Co-authored-by: Steven Masley &lt;stevenmasley@coder.com&gt;
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -124,7 +124,7 @@
       "path": "./secrets.md"
     },
     {
-      "title": "User Management",
+      "title": "Users",
       "description": "Learn about user roles available in Coder and how to create and manage users",
       "icon_path": "./images/icons/users.svg",
       "path": "./users.md"
diff --git a/docs/users.md b/docs/users.md
@@ -1,15 +1,21 @@
-# User management
+# Users
 
 This article walks you through the user roles available in Coder and creating and managing users.
 
-## User roles
+## Roles
 
-Coder offers three user roles:
+Coder offers these user roles in the community edition:
 
-* **Admin**: Has full access to the Coder system, including all workspaces, users, organizations, and templates
-* **Member**: Has limited access to Coder; can create workspaces using the templates and resources they have access to
-* **Auditor**: Has the same access rights as a **member**, as well as access to
-  audit logs
+|                                            | User Admin | Template Admin | Admin |
+| ------------------------------------------ | ---------- | -------------- | ----- |
+| Add and remove Users                       | ✅         |                | ✅    |
+| Change User roles                          |            |                | ✅    |
+| Manage Templates                           |            | ✅             | ✅    |
+| View, update and delete **ALL** Workspaces |            | ✅             | ✅    |
+| Execute and use **ALL** Workspaces         |            |                | ✅    |
+
+A user may have one or more roles. All users have an implicit Member role
+that may use personal workspaces.
 
 ## Create a user
 
@@ -42,8 +48,8 @@ https://github.com/coder/coder/releases
 
 Run  coder login https://<accessURL>.coder.app  to authenticate.
 
-Your email is:  email@exampleCo.com 
-Your password is:  <redacted> 
+Your email is:  email@exampleCo.com
+Your password is:  <redacted>
 
 Create a workspace   coder create !
 ```
diff --git a/site/src/components/Tooltips/UserRoleHelpTooltip.tsx b/site/src/components/Tooltips/UserRoleHelpTooltip.tsx
@@ -21,7 +21,7 @@ export const UserRoleHelpTooltip: FC = () => {
       <HelpTooltipTitle>{Language.title}</HelpTooltipTitle>
       <HelpTooltipText>{Language.text}</HelpTooltipText>
       <HelpTooltipLinksGroup>
-        <HelpTooltipLink href="https://coder.com/docs/coder-oss/latest/users">
+        <HelpTooltipLink href="https://coder.com/docs/coder-oss/latest/users#user-roles">
           {Language.link}
         </HelpTooltipLink>
       </HelpTooltipLinksGroup>

Original file line number	Diff line number	Diff line change
`@@ -124,7 +124,7 @@`
`124`	`124`	`"path": "./secrets.md"`
`125`	`125`	`},`
`126`	`126`	`{`
`127`		`- "title": "User Management",`
	`127`	`+ "title": "Users",`
`128`	`128`	`"description": "Learn about user roles available in Coder and how to create and manage users",`
`129`	`129`	`"icon_path": "./images/icons/users.svg",`
`130`	`130`	`"path": "./users.md"`