feat: revise workspaces page and add tweaks to lifecycle page (coder#908)

bpmct · web-flow · commit 3213eb005415 · 2022-04-05T11:55:07.000-05:00
diff --git a/workspaces/index.md b/workspaces/index.md
@@ -20,12 +20,10 @@ icon:
 description: "Learn about development workspaces in Coder."
 ---
 
-A workspace is your remote development environment.
-
-![Workspaces](../assets/workspaces/workspaces.svg)
-
-Coder creates workspaces using a [shared container image](../images/index.md),
-which improves their reproducibility.
+Workspaces contain the dependencies, IDEs, and configuration information needed
+for your projects. Coder creates workspaces using a
+[shared container image](../images/index.md), which improves their
+reproducibility.
 
 ![The anatomy of a workspace](../assets/workspaces/workspace-anatomy.png)
 
diff --git a/workspaces/lifecycle.md b/workspaces/lifecycle.md
@@ -41,6 +41,9 @@ After a workspace hasn't been accessed for the specified threshold, it is shut
 down. A stopped workspace requires a [rebuild](#Rebuilds) before you can access
 it again.
 
+Optionally, you can allow users to modify or disable auto-off criteria for
+specific workspaces at the organization level.
+
 ## Hooks
 
 Coder exposes a few hooks during the build process. Once a workspace is
