coder
diff --git a/‎assets/workspaces/lifecycles.png
189 KB b/‎assets/workspaces/lifecycles.png
189 KB
diff --git a/‎assets/workspaces/workspace-anatomy.png
124 KB b/‎assets/workspaces/workspace-anatomy.png
124 KB
diff --git a/‎workspaces/getting-started.md
+5 b/‎workspaces/getting-started.md
+5
diff --git a/‎workspaces/index.md
+6-2 b/‎workspaces/index.md
+6-2
@@ -3,6 +3,11 @@ 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.
+
+![Relationship between images and workspaces](../assets/workspaces/lifecycles.png)
+
 ## 1. Import an image
 
 Ensure you've [imported an image](../images/importing.md) for your
 
@@ -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)
 
+All workspaces are based on a shared [image](../images/index.md) and therefore
+reproducible.
+
+![The anatomy of a workspace](../assets/workspaces/workspace-anatomy.png)
+
 ## In this section
 
 <children></children>