changes from call

bpmct · bpmct · commit e87fb94f2dae · 2023-06-22T15:20:59.000Z
diff --git a/docs/templates/index.md b/docs/templates/index.md
@@ -73,11 +73,30 @@ coder templates create <template-name>
 
 By default, developers have unlimited workspace usage and can use any template version. Template policies allows you to:
 
-- 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.
+- Require workspaces to be restarted frequently to ensure they use the most recent template version.
 - Disable workspace auto-start.
 
+### Stop policy
+
+Stop policies require workspaces be stopped (or restarted), regardless of activity:
+
+- Daily (Restart on next quiet hours)
+- Weekly (Restart on weekends)
+- Custom (Every 2 weeks)
+
+  ```text
+   Every [2] [Weeks] on [Friday]
+   or
+   Every [2] [Days]
+   or
+   Every [4] [Weeks] on [Saturday]
+   ```
+
+- Never
+
+Stops occur during a user's [quiet hours](../workspaces.md#quiet-hours), which prevent interruptions. If a user is still using their workspace, they can postpone a restart up to 3 hours.
+
 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 -->
diff --git a/docs/workspaces.md b/docs/workspaces.md
@@ -59,10 +59,27 @@ Workspaces may also have a max lifetime, which enforces a stop or restart even i
 
 ![TODO: use real screenshot](./images/workspaces/approaching-stop.png)
 
+#### Quiet hours
+
 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.
 
+Example:
+
+```text
+Quiet hours: 12- 4:00 AM
+11:30AM: User is notified their workspace is about to stop
+
+user bumps
+user bumps
+user bumps
+
+4 AM: workspace stops
+```
+
 ![TODO: use real screenshot](./images/workspaces/quiet-hours.png)
 
+<!-- NOTE: This will be in the "Account settings" page -->
+
 Admin controls around workspace auto-stop are an enterprise feature. [Learn more here](./admin/template)
 
 ## Updating workspaces
