docs: document definition of workspace activity (#16941)

closes: https://github.com/coder/coder/issues/16884

aligns the documentation with what users see when they adjust settings
and uses the [notion
discussion](https://www.notion.so/coderhq/Definitions-of-Workspace-Usage-Autostop-Dormancy-e7fa8ff782a948c19bbe4ef8315c26cb)
as a reference. This PR reflects current behavior from what I can tell.


[preview](https://coder.com/docs/@16884-define-activity/user-guides/workspace-scheduling#activity-detection)

---------

Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
This commit is contained in:
Edward Angert
2025-03-21 10:36:24 -04:00
committed by GitHub
co-authored by EdwardAngert
parent f4b6f429c6
commit bbe7dacd35
2 changed files with 37 additions and 19 deletions
@@ -14,8 +14,7 @@ Template [admins](../../users/index.md) may define these default values:
stops it.
- [**Autostop requirement**](#autostop-requirement): Enforce mandatory workspace
restarts to apply template updates regardless of user activity.
- **Activity bump**: The duration of inactivity that must pass before a
workspace is automatically stopped.
- **Activity bump**: The duration by which to extend a workspace's deadline when activity is detected (default: 1 hour). The workspace will be considered inactive when no sessions are detected (VSCode, JetBrains, Terminal, or SSH). For details on what counts as activity, see the [user guide on activity detection](../../../user-guides/workspace-scheduling.md#activity-detection).
- **Dormancy**: This allows automatic deletion of unused workspaces to reduce
spend on idle resources.