chore: add labels and standardize enterprise messaging

bpmct · bpmct · commit f332528f86bc · 2022-10-11T18:13:50.000Z
diff --git a/docs/admin/audit-logs.md b/docs/admin/audit-logs.md
@@ -1,6 +1,6 @@
 # Audit Logs
 
-Audit Logs allows **Admins** and **Auditors** to monitor user operations in
+Audit Logs allows **Auditors** to monitor user operations in
 their deployment.
 
 ## Tracked Events
@@ -32,4 +32,4 @@ The supported filters are:
 
 ## Enabling this feature
 
-This feature is auto enabled for all enterprise deployments. Admins may contact us to purchase a license [here](https://coder.com/contact?note=I%20want%20to%20upgrade%20my%20license).
+This feature is only available with an enterprise license. [Learn more](./enterprise.md)
diff --git a/docs/admin/enterprise.md b/docs/admin/enterprise.md
@@ -7,13 +7,14 @@ These features are available in the enterprise edition:
 
 - [Audit Logging](./audit-logs.md)
 - [Browser Only Connections](../networking.md#browser-only-connections)
+- [Groups](./groups.md)
+- [Template RBAC](./rbac.md)
 - [Quotas](./quotas.md)
 - [SCIM](./auth.md#scim)
 
 And we're releasing these imminently:
 
 - High Availability
-- Template RBAC
 - Multiple Git Provider Authentication
 
 ## Adding your license key
diff --git a/docs/admin/groups.md b/docs/admin/groups.md
@@ -1,7 +1,10 @@
-# User Groups
+# Groups
 
-Groups are helpful for defining a set of common permissions for a group of users. It can be used with [RBAC](../rbac.md) to have a better access control.
+Groups can be used with [template RBAC](./rbac.md) to give groups of users access to specific templates.
+
+![Groups](../images/groups.png)
 
 ## Enabling this feature
 
-This feature is auto enabled for all enterprise deployments. Admins may contact us to purchase a license [here](https://coder.com/contact?note=I%20want%20to%20upgrade%20my%20license).
+This feature is only available with an enterprise license. [Learn more](./enterprise.md)
+
diff --git a/docs/admin/quotas.md b/docs/admin/quotas.md
@@ -15,6 +15,10 @@ Then, when users create workspaces they would see:
 
 <img src="../images/admin/quotas.png"/>
 
+## Enabling this feature
+
+This feature is only available with an enterprise license. [Learn more](./enterprise.md)
+
 ## Up next
 
 - [Enterprise](./enterprise.md)
diff --git a/docs/admin/rbac.md b/docs/admin/rbac.md
@@ -1,17 +1,18 @@
 # Role Based Access Control (RBAC)
 
-RBAC helps admins to control what their users and [groups](./groups.md) can access.
+Use RBAC to define which users and [groups](./groups.md) can use specific templates in Coder.
 
-> **Note**:
-> Right now, the only resource type where an admin can use RBAC is [Template](../templates.md) but we are planning to extend this capability to other resource types as well.
+![rbac](../images/template-rbac.png)
+
+The "Everyone" group makes a template accessable to all users. This can be removed to make a template private.
 
 ## Permissions
 
 You can set the following permissions:
 
-- **Admin**. Can edit and remove the resource including the permissions.
-- **View**. Can only read and access the resource.
+- **Admin**: Read, access, edit, push, and delete
+- **View**: Read, access
 
 ## Enabling this feature
 
-This feature is auto-enabled for all enterprise deployments. Admins may contact us to purchase a license [here](https://coder.com/contact?note=I%20want%20to%20upgrade%20my%20license).
+This feature is only available with an enterprise license. [Learn more](./enterprise.md)
diff --git a/docs/admin/users.md b/docs/admin/users.md
@@ -7,12 +7,12 @@ This article walks you through the user roles available in Coder and creating an
 Coder offers these user roles in the community edition:
 
 |                                            | User Admin | Template Admin | Owner |
-| ------------------------------------------ | ---------- | -------------- |-------|
-| Add and remove Users                       | ✅         |                | ✅     |
-| Change User roles                          |            |                | ✅     |
-| Manage Templates                           |            | ✅             | ✅     |
-| View, update and delete **ALL** Workspaces |            | ✅             | ✅     |
-| Execute and use **ALL** Workspaces         |            |                | ✅     |
+| ------------------------------------------ | ---------- | -------------- | ----- |
+| 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.
diff --git a/docs/images/groups.png b/docs/images/groups.png
diff --git a/docs/images/icons/rbac.svg b/docs/images/icons/rbac.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" enable-background="new 0 0 24 24" height="24" viewBox="0 0 24 24" width="24"><g><rect fill="none" height="24" width="24"/></g><g><g><path d="M17,11c0.34,0,0.67,0.04,1,0.09V6.27L10.5,3L3,6.27v4.91c0,4.54,3.2,8.79,7.5,9.82c0.55-0.13,1.08-0.32,1.6-0.55 C11.41,19.47,11,18.28,11,17C11,13.69,13.69,11,17,11z"/><path d="M17,13c-2.21,0-4,1.79-4,4c0,2.21,1.79,4,4,4s4-1.79,4-4C21,14.79,19.21,13,17,13z M17,14.38c0.62,0,1.12,0.51,1.12,1.12 s-0.51,1.12-1.12,1.12s-1.12-0.51-1.12-1.12S16.38,14.38,17,14.38z M17,19.75c-0.93,0-1.74-0.46-2.24-1.17 c0.05-0.72,1.51-1.08,2.24-1.08s2.19,0.36,2.24,1.08C18.74,19.29,17.93,19.75,17,19.75z"/></g></g></svg>
diff --git a/docs/images/template-rbac.png b/docs/images/template-rbac.png
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -1,5 +1,9 @@
 {
-  "versions": ["main", "v0.8.1", "v0.7.12"],
+  "versions": [
+    "main",
+    "v0.8.1",
+    "v0.7.12"
+  ],
   "routes": [
     {
       "title": "About",
@@ -170,6 +174,12 @@
       "icon_path": "./images/icons/wrench.svg",
       "path": "./admin/index.md",
       "children": [
+        {
+          "title": "Authentication",
+          "description": "Learn how to set up authentication using GitHub or OpenID Connect.",
+          "icon_path": "./images/icons/key.svg",
+          "path": "./admin/auth.md"
+        },
         {
           "title": "Users",
           "description": "Learn about user roles available in Coder and how to create and manage users",
@@ -180,19 +190,15 @@
           "title": "Groups",
           "description": "Learn how to manage user groups",
           "icon_path": "./images/icons/group.svg",
-          "path": "./admin/groups.md"
+          "path": "./admin/groups.md",
+          "state": "enterprise"
         },
         {
           "title": "RBAC",
           "description": "Learn how to use the role based access control",
-          "icon_path": "./images/icons/key.svg",
-          "path": "./admin/rbac.md"
-        },
-        {
-          "title": "Authentication",
-          "description": "Learn how to set up authentication using GitHub or OpenID Connect.",
-          "icon_path": "./images/icons/key.svg",
-          "path": "./admin/auth.md"
+          "icon_path": "./images/icons/rbac.svg",
+          "path": "./admin/rbac.md",
+          "state": "enterprise"
         },
         {
           "title": "Configuration",
diff --git a/docs/templates.md b/docs/templates.md
@@ -310,6 +310,10 @@ practices:
   - The Coder agent logs are typically stored in `/var/log/coder-agent.log`
   - The Coder agent startup script logs are typically stored in `/var/log/coder-startup-script.log`
 
+## Template permissions (enterprise)
+
+Template permissions can be used to give users and groups access to specific templates. [Learn more about RBAC](./admin/rbac.md).
+
 ## Change Management
 
 We recommend source controlling your templates as you would other code.
