Expanded tutorial

I have read the CLA Document and I hereby sign the CLA
coder · matifali · Oct 16, 2023 · Aug 16, 2023 · Aug 17, 2023 · Aug 17, 2023
commit 50e904165a68d8a86ce3fbcc4c299be72fbd1b80
diff --git a/docs/images/templates/create-template.png b/docs/images/templates/create-template.png
diff --git a/docs/images/templates/create-workspace.png b/docs/images/templates/create-workspace.png
diff --git a/docs/images/templates/new-workspace.png b/docs/images/templates/new-workspace.png
diff --git a/docs/images/templates/use-template.png b/docs/images/templates/use-template.png
diff --git a/docs/images/templates/workspace-ready.png b/docs/images/templates/workspace-ready.png
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -139,8 +139,8 @@
       "icon_path": "./images/icons/picture.svg",
       "children": [
         {
-          "title": "Creating, editing, and updating templates",
-          "description": "Working with templates",
+          "title": "Working with templates",
+          "description": "Creating, editing, and updating templates",
           "path": "./templates/creating.md"
         },
         {

diff --git a/docs/templates/tutorial.md b/docs/templates/tutorial.md
@@ -2,52 +2,69 @@
 
 A common way to create a template is to begin with a starter template
 then modify it for your needs. Coder makes this easy with starter
-templates for popular development targets, like Docker, Kubernetes,
+templates for popular development targets like Docker, Kubernetes,
 Azure, and so on. Once your template is up and running, you can edit
 it in the Coder web page. Coder even handles versioning for you.
 
 In this tutorial, you'll create your first template from the Docker
-starter template. You'll need ssh access to a computer that has both
-Docker and Coder installed on it.
+starter template. You'll need a computer or cloud computing instance
+with both Docker and Coder installed on it.
 
-To create a template, you'll work with both the Coder web page and the
-command line. You only need to do this once to create a template.
-After that, you can edit your template from the Coder web page.
 
 ## Log in to Coder
 
 In your web browser, go to your Coder instance to log in.
 
-Also, in a terminal, ssh into the computer where Docker and Coder are
-installed, then log into Coder.
-
-```console
-marc@example:~$ coder login https://example-access-url.coder.app
-Open the following in your browser:
-
-        https://example-access-url.coder.app/cli-auth
-
-> Paste your token here:
-> Welcome to Coder, marc! You're authenticated.
-marc@example:~$ 
-```
 
 ## Choose a starter template
 
-In the web browser, select **Templates** > **Starter Templates**.
+### 1. Choose a starter template
+
+Select **Templates** > **Starter Templates**.
 
 ![Starter Templates button](../images/templates/starter-templates.png)
 
 In **Filter**, select **Docker** then select **Develop in Docker**.
 
 ![Choosing a starter template](../images/templates/develop-in-docker-template.png)
 
-## Try out your new template
+Select **Use template**.
+
+![Using a starter template](../images/use-template.png)
+
+### 2. Create your template
+
+In **Create template**, fill in **Name** and **Display name**,then scroll down and select **Create template**.
+
+![Creating a template](../images/create-template.png)
+
+### 3. Create a workspace from your template
+
+When the template is ready, select **Create Workspace**.
+
+![Create workspace](../images/create-workspace.png)
+
+In **New workspace**, fill in **Name** then scroll down to select **Create Workspace**.
+
+![New workspace](../images/new-workspace.png)
+
+Coder starts your new workspace from your template.
+
+### 4. Use your workspace
+
+After a few seconds, you can use your workspace. This starter template
+lets you connect to your workspace via VS Code, coder-server, a
+browser-based terminal, or SSH.
+
+![Workspace is ready](../images/workspace-ready.png)
+
+
+## Try out your new workspace
+
 
 
 ## Creating a template for Kubernetes
 
 ## Next steps
-
 - [Anatomy of a template](./anatomy.md)
 - [Setting up templates](./best-practices.md)