docs: add auto-start/stop (#4728)

* docs: add auto-start/stop

* feedback

Co-authored-by: Ben Potter <ben@coder.com>

Co-authored-by: Ben Potter <ben@coder.com>

docs/workspaces.md

@@ -24,7 +24,7 @@ Coder [supports multiple IDEs](ides.md) for use with your workspaces.
 
 Workspaces in Coder are started and stopped, often based on whether there was
 any activity or if there was a [template
-update](./templates.md#manage-templates) available.
+update](./templates.md#start/stop) available.
 
 Resources are often destroyed and re-created when a workspace is restarted,
 though the exact behavior depends on the template's definitions. For more
@@ -40,6 +40,28 @@ resources](./templates.md#persistent-vs-ephemeral-resources).
 
 When a workspace is deleted, all of the workspace's resources are deleted.
 
+## Workspace scheduling
+
+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.
+
+![Scheduling UI](./images/schedule.png)
+
+### Auto-start
+
+The auto-start feature automates the workspace build at a user-specified time
+and day(s) of the week. In addition, users can select their preferred timezone.
+
+![Auto-start UI](./images/auto-start.png)
+
+### Auto-stop
+
+The auto-stop feature shuts off workspaces after given number of hours in the "on"
+state. If Coder detects workspace connection activity, the auto-stop timer is bumped up
+one hour. IDE, SSH, Port Forwarding, and coder_app activity trigger this bump.
+
+![auto-stop UI](./images/auto-stop.png)
+
 ## Updating workspaces
 
 Use the following command to update a workspace to the latest template version.