quick copy edit

EdwardAngert · EdwardAngert · commit 3281d6afcda9 · 2024-11-01T18:55:06.000Z
diff --git a/docs/tutorials/template-from-scratch.md b/docs/tutorials/template-from-scratch.md
@@ -1,27 +1,12 @@
-# A guided tour of a template
+# Write a template from scratch
 
-This guided tour introduces you to the different parts of a Coder template by
-showing you how to create a template from scratch.
+A template is a common configuration that you use to deploy workspaces.
 
-You'll write a simple template that provisions a workspace as a Docker container
-with Ubuntu.
+This tutorial teaches you how to create a template that provisions a workspace as a Docker container with Ubuntu.
 
 ## Before you start
 
-To follow this guide, you'll need:
-
-- A computer or cloud computing instance with both
-  [Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md)
-  installed on it.
-
-  - When setting up your computer or computing instance, make sure to install
-    Docker first, then Coder. Otherwise, you'll need to add the `coder` user to
-    the `docker` group.
-
-- The URL for your Coder instance. If you're running Coder locally, the default
-  URL is [http://127.0.0.1:3000](http://127.0.0.1:3000).
-
-- A text editor. For this tour, we use [GNU nano](https://nano-editor.org/).
+You'll need a computer or cloud computing instance with both [Docker](https://docs.docker.com/get-docker/) and [Coder](../install/index.md) installed on it.
 
 ## What's in a template
 
@@ -37,22 +22,21 @@ started, or stopped.
 > [Getting Started Guides](https://developer.hashicorp.com/terraform/tutorials).
 
 Here's a simplified diagram that shows the main parts of the template we'll
-create.
+create:
 
 ![Template architecture](../images/templates/template-architecture.png)
 
 ## 1. Create template files
 
 On your local computer, create a directory for your template and create the
-`Dockerfile`.
+`Dockerfile`. You will upload the files to your Coder instance later.
 
 ```sh
 mkdir -p template-tour/build && cd $_
-nano Dockerfile
 ```
 
-You'll enter a simple `Dockerfile` that starts with the
-[official Ubuntu image](https://hub.docker.com/_/ubuntu/). In the editor, enter
+Enter content into a `Dockerfile` that starts with the
+[official Ubuntu image](https://hub.docker.com/_/ubuntu/). In your editor, enter
 and save the following text in `Dockerfile` then exit the editor:
 
 ```dockerfile
@@ -72,21 +56,17 @@ USER ${USER}
 WORKDIR /home/${USER}
 ```
 
-Notice how `Dockerfile` adds a few things to the parent `ubuntu` image, which
+`Dockerfile` adds a few things to the parent `ubuntu` image, which
 your template needs later:
 
 - It installs the `sudo` and `curl` packages.
 - It adds a `coder` user, including a home directory.
 
 ## 2. Set up template providers
 
-Edit the Terraform file to provision the workspace's resources:
-
-```shell
-nano main.tf
-```
+Edit the Terraform `main.tf` file to provision the workspace's resources.
 
-We'll start by setting up our providers. At a minimum, we need the `coder`
+Start by setting up the providers. At a minimum, we need the `coder`
 provider. For this template, we also need the `docker` provider:
 
 ```tf
@@ -126,7 +106,7 @@ The
 [`coder_workspace`](https://registry.terraform.io/providers/coder/coder/latest/docs/data-sources/workspace)
 data source provides details about the state of a workspace, such as its name,
 owner, and so on. The data source also lets us know when a workspace is being
-started or stopped. We'll take advantage of this information in later steps to:
+started or stopped. We'll use this information in later steps to:
 
 - Set some environment variables based on the workspace owner.
 - Manage ephemeral and persistent storage.
@@ -140,10 +120,9 @@ runs inside the compute aspect of your workspace, typically a VM or container.
 In our case, it will run in Docker.
 
 You do not need to have any open ports on the compute aspect, but the agent
-needs `curl` access to the Coder server. Remember that we installed `curl` in
-`Dockerfile`, earlier.
+needs `curl` access to the Coder server.
 
-Add this snippet below the last closing `}` in `main.tf` to create the agent:
+Add this snippet after the last closing `}` in `main.tf` to create the agent:
 
 ```tf
 resource "coder_agent" "main" {
@@ -184,29 +163,26 @@ resource "coder_agent" "main" {
 
 Because Docker is running locally in the Coder server, there is no need to
 authenticate `coder_agent`. But if your `coder_agent` is running on a remote
-host, your template would need
+host, your template will need
 [authentication credentials](../admin/external-auth.md).
 
 This template's agent also runs a startup script, sets environment variables,
 and provides metadata.
 
-The
-[`startup script`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script)
-installs [code-server](https://coder.com/docs/code-server), a browser-based
-[VS Code](https://code.visualstudio.com/) app that runs in the workspace. We'll
-give users access to code-server through `coder_app`, later.
+- [`startup script`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#startup_script)
+  - Installs [code-server](https://coder.com/docs/code-server), a browser-based [VS Code](https://code.visualstudio.com/) app that runs in the workspace.
 
-The
-[`env`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#env)
-block sets environments variables for the workspace. We use the data source from
-`coder_workspace` to set the environment variables based on the workspace's
-owner. This way, the owner can make git commits immediately without any manual
-configuration.
+    We'll give users access to code-server through `coder_app`, later.
+
+- [`env` block](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#env)
+  - Sets environments variables for the workspace.
+
+    We use the data source from `coder_workspace` to set the environment variables based on the workspace's owner. This way, the owner can make git commits immediately without any manual configuration.
+
+- [`metadata`](../admin/templates/extending-templates/agent-metadata.md) blocks
+  - Your template can use metadata to show information to the workspace owner Coder displays this metadata in the Coder dashboard.
 
-Your template can use metadata to show information to the workspace owner. Coder
-displays this metadata in the Coder dashboard. Our template has
-[`metadata`](../admin/templates/extending-templates/agent-metadata.md) blocks
-for CPU and RAM usage.
+    Our template has `metadata` blocks for CPU and RAM usage.
 
 ## 4. coder_app
 
@@ -220,10 +196,7 @@ This is commonly used for
 [web IDEs](../user-guides/workspace-access/web-ides.md) such as
 [code-server](https://coder.com/docs/code-server), RStudio, and JupyterLab.
 
-To install code-server in the workspace, remember that we installed it in the
-`startup_script` argument in `coder_agent`. We make it available from a
-workspace with a `coder_app` resource. See
-[web IDEs](../user-guides/workspace-access/web-ides.md) for more examples.
+We installed code-server in the `startup_script` argument. To add code-server to the workspace, make it available from a workspace with a `coder_app` resource. See [web IDEs](../user-guides/workspace-access/web-ides.md) for more examples.
 
 ```tf
 resource "coder_app" "code-server" {
