diff --git a/assets/workspaces/workspace-anatomy.png b/assets/workspaces/workspace-anatomy.png new file mode 100644 index 000000000..fd7cc2f75 Binary files /dev/null and b/assets/workspaces/workspace-anatomy.png differ diff --git a/workspaces/getting-started.md b/workspaces/getting-started.md index d8d80e9c6..277483bbe 100644 --- a/workspaces/getting-started.md +++ b/workspaces/getting-started.md @@ -3,6 +3,9 @@ title: "Getting started" description: "Learn how to develop in a workspace." --- +This article walks you through creating a new workspace using a pre-defined +image. + ## 1. Import an image Ensure you've [imported an image](../images/importing.md) for your diff --git a/workspaces/index.md b/workspaces/index.md index 41612c0a2..460fcce7b 100644 --- a/workspaces/index.md +++ b/workspaces/index.md @@ -20,11 +20,15 @@ icon: description: "Learn about development workspaces in Coder." --- -A workspace is your remote development environment. All workspaces are based on -a shared [image](../images/index.md) and therefore reproducible. +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. + +![The anatomy of a workspace](../assets/workspaces/workspace-anatomy.png) + ## In this section