reconbug
diff --git a/‎docs/images/workspaces/approaching-stop.png
94.7 KB b/‎docs/images/workspaces/approaching-stop.png
94.7 KB
diff --git a/‎docs/images/workspaces/quiet-hours.png
237 KB b/‎docs/images/workspaces/quiet-hours.png
237 KB
diff --git a/‎docs/images/workspaces/stops-after-3-hours.png
170 KB b/‎docs/images/workspaces/stops-after-3-hours.png
170 KB
diff --git a/‎docs/templates/index.md
Lines changed: 10 additions & 6 deletions b/‎docs/templates/index.md
Lines changed: 10 additions & 6 deletions
diff --git a/‎docs/workspaces.md
Lines changed: 19 additions & 13 deletions b/‎docs/workspaces.md
Lines changed: 19 additions & 13 deletions
@@ -69,14 +69,18 @@ coder templates create <template-name>
 > [examples/](https://github.com/coder/coder/tree/main/examples/templates)
 > directory in the repo.
 
-## Configure Max Workspace Autostop
+## Template policies (enterprise)
 
-To control cost, specify a maximum time to live flag for a template in hours or
-minutes.
+By default, developers have unlimited workspace usage and can use any template version. Template policies allows you to:
 
-```sh
-coder templates create my-template --default-ttl 4h
-```
+- Guarantee developers are using the most recent template version.
+- Auto-stop workspaces after 3 hours of inactivity.
+- Mandate stopping/restarting of workspaces, regardless of activity status.
+- Disable workspace auto-start.
+
+Learn more about [workspace auto-stop](../workspaces.md#workspace-auto-stop)
+
+<!-- TODO: Add the dashboard screenshots. We can remove the "most recent version" bullet point once we finish template version policies -->
 
 ## Customize templates
 
 
@@ -37,27 +37,33 @@ information, see [Resource Persistence](./templates/resource-persistence.md).
 
 When a workspace is deleted, all of the workspace's resources are deleted.
 
-## Workspace scheduling
+## Workspace auto-stop
 
-By default, workspaces are manually turned on/off by the user. However, a schedule
-can be defined on a per-workspace basis to automate the workspace start/stop.
+In Coder, workspaces can auto-stop when the user is not actively using the workspace. By default, Coder recognizing the following actions as activity and will keep the workspace online:
 
-![Scheduling UI](./images/schedule.png)
+- Open SSH connections (VS Code Extension, JetBrains Gateway, `coder ssh`)
+- Open tunnels (`coder port-forward`)
+- Open WebSockets (web terminal, [web IDEs](./ides/web-ides.md) such as code-server and JupyterLab)
 
-### Autostart
+> [Custom activity](#TODO) can be registered via Coder's REST API, such as an ongoing data science pipeline.
 
-The autostart feature automates the workspace build at a user-specified time
-and day(s) of the week. In addition, users can select their preferred timezone.
+<!-- TODO. Document this. We may want to move to a custom activity section. See coder/coder[#8064](https://github.com/coder/coder/issues/8064) and coder/coder#5629 -->
 
-![Autostart UI](./images/autostart.png)
+Your workspace's auto-stop behavior can be seen in the dashboard. Template settings in Coder determine if users can alter their workspace schedules. 
 
-### Autostop
+![TODO: use real screenshot](./images/workspaces/stops-after-3-hours.png)
 
-The autostop feature shuts off workspaces after given number of hours in the "on"
-state. If Coder detects workspace connection activity, the autostop timer is bumped up
-one hour. IDE, SSH, Port Forwarding, and coder_app activity trigger this bump.
+### Max workspace lifetime (enterprise)
 
-![autostop UI](./images/autostop.png)
+Workspaces may also have a max lifetime, which enforces a stop or restart even if you are actively using your workspace.
+
+![TODO: use real screenshot](./images/workspaces/approaching-stop.png)
+
+To avoid interruptions, users can establish their "quiet hours", which are by default set from midnight to 4 AM, during which these actions occur. Users can also extend the deadline by up to 3 hours if they are in the middle of important work.
+
+![TODO: use real screenshot](./images/workspaces/quiet-hours.png)
+
+Admin controls around workspace auto-stop are an enterprise feature. [Learn more here](./admin/template)
 
 ## Updating workspaces