docs: add quotas (coder#4366)

ammario · web-flow · commit a6bb3b29d02c · 2022-10-04T20:55:43.000Z
diff --git a/docs/admin/enterprise.md b/docs/admin/enterprise.md
@@ -5,10 +5,10 @@ Contact sales@coder.com to obtain a license.
 
 Our Enterprise-only features include:
 
-- Audit Logging
+- [Audit Logging](./audit-logs.md)
 - Browser Only Connections
 - Template RBAC
-- Quotas
+- [Quotas](./quotas.md)
 - High Availability
 
 ## Adding your license key
diff --git a/docs/admin/quotas.md b/docs/admin/quotas.md
@@ -0,0 +1,25 @@
+# Quotas
+
+<blockquote class="info">
+Workspace Quotas are only available in the Enterprise Edition.
+</blockquote>
+
+Coder Enterprise admins may define deployment-level quotas to protect against
+Denial-of-Service, control costs, and ensure equitable access to cloud resources.
+
+The quota is enabled by either the `CODER_USER_WORKSPACE_QUOTA`
+environment variable or the `--user-workspace-quota` flag. For example,
+you may limit each user in a deployment to 5 workspaces like so:
+
+```bash
+coder server --user-workspace-quota=5
+```
+
+Then, when users create workspaces they would see:
+
+<img src="../images/admin/quotas.png"/>
+
+## Up next
+
+- [Enterprise](./enterprise.md)
+- [Configuring](./configure.md)
diff --git a/docs/images/admin/quotas.png b/docs/images/admin/quotas.png
diff --git a/docs/images/icons/dollar.svg b/docs/images/icons/dollar.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24" width="24"><path d="M0 0h24v24H0z" fill="none"/><path d="M11.8 10.9c-2.27-.59-3-1.2-3-2.15 0-1.09 1.01-1.85 2.7-1.85 1.78 0 2.44.85 2.5 2.1h2.21c-.07-1.72-1.12-3.3-3.21-3.81V3h-3v2.16c-1.94.42-3.5 1.68-3.5 3.61 0 2.31 1.91 3.46 4.7 4.13 2.5.6 3 1.48 3 2.41 0 .69-.49 1.79-2.7 1.79-2.06 0-2.87-.92-2.98-2.1h-2.2c.12 2.19 1.76 3.42 3.68 3.83V21h3v-2.15c1.95-.37 3.5-1.5 3.5-3.55 0-2.84-2.43-3.81-4.7-4.4z"/></svg>
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -186,7 +186,7 @@
         },
         {
           "title": "Configuration",
-          "description": "Learn how to configure Coder",
+          "description": "Learn how to configure Coder.",
           "path": "./admin/configure.md",
           "icon_path": "./images/icons/toggle_on.svg"
         },
@@ -202,6 +202,12 @@
           "icon_path": "./images/icons/radar.svg",
           "path": "./admin/audit-logs.md"
         },
+        {
+          "title": "Quotas",
+          "description": "Learn how to use Workspace Quotas in Coder.",
+          "icon_path": "./images/icons/dollar.svg",
+          "path": "./admin/quotas.md"
+        },
         {
           "title": "Enterprise",
           "description": "Learn how to enable Enterprise features.",
@@ -210,7 +216,7 @@
         },
         {
           "title": "Telemetry",
-          "description": "Learn what usage telemetry Coder collects",
+          "description": "Learn what usage telemetry Coder collects.",
           "icon_path": "./images/icons/science.svg",
           "path": "./admin/telemetry.md"
         }
