coder · ammario · Jul 31, 2022 · Jul 31, 2022 · Jul 31, 2022
diff --git a/docs/ides.md b/docs/ides.md
@@ -4,9 +4,7 @@ The following desktop IDEs have been tested with Coder, though any IDE with SSH
 support should work:
 
 - [VS Code Remote SSH](#vs-code-remote)
-  extension)
 - [JetBrains with Gateway](./ides/configuring-gateway.md)
-  installed)
   - IntelliJ IDEA
   - CLion
   - GoLand

diff --git a/docs/ides/configuring-gateway.md b/docs/ides/configuring-gateway.md
@@ -1,57 +1,36 @@
 # Configuring JetBrains Gateway
 
-The following screenshots outline in more detail how to create a new Connection
-for JetBrains Gateway to a Coder workspace.
+The following walkthrough details how to connect JetBrains Gateway to
+Coder.
 
 ## Creating a new JetBrains Gateway Connection
 
-After installing Gateway on your local system, you may connect to a Coder
-workspace as follows
-
+1. [Install Gateway](https://www.jetbrains.com/help/idea/jetbrains-gateway.html)
+1. [Configure the `coder` CLI](../ides.md#ssh-configuration)
 1. Open Gateway, make sure "SSH" is selected under "Remote Development"
-2. Click "New Connection"
-
-![Gateway Home](../images/gateway/gateway-home.png)
-
-3. In the resulting dialog, click the gear icon to the right of "Connection:"
-
-![Gateway New Connection](../images/gateway/gateway-new-connection.png)
-
-4. Hit the "+" button to add a new SSH connection
-
-![Gateway Add Connection](../images/gateway/gateway-add-ssh-configuration.png)
-
-   1. For the Host, enter `coder.<workspace name>`
-   2. For the Port, enter `22` (this is ignored by Coder)
-   3. For the Username, enter `coder`
-   4. For the Authentication Type, select "OpenSSH config and authentication
-      agent"
-   5. Make sure the checkbox for "Parse config file ~/.ssh/config" is checked.
-   6. Click "Test Connection" to ensure you setting are ok.
-   7. Click "OK"
-
-![Gateway SSH
-Configuration](../images/gateway/gateway-create-ssh-configuration.png)
-
-5. Select the connection you just added.
-
-![Gateway Welcome](../images/gateway/gateway-welcome.png)
-
-6. Click "Check Connection and Continue"
-
-![Gateway Continue](../images/gateway/gateway-continue.png)
-
-7. Select the JetBrains IDE for your project and the project directory
-   1. Use an SSH terminal to your workspace to create a directory or check out
-      code if you haven't already.
-
-> Note the JetBrains IDE is installed in the directory `~/.
-> cache/JetBrains/RemoteDev/dist`
-
-![Gateway Choose IDE](../images/gateway/gateway-choose-ide.png)
-
-8. Click "Download and Start IDE" to connect.
-
-![Gateway IDE Opened](../images/gateway/gateway-intellij-opened.png)
-
-
+1. Click "New Connection"
+   ![Gateway Home](../images/gateway/gateway-home.png)
+1. In the resulting dialog, click the gear icon to the right of "Connection:"
+   ![Gateway New Connection](../images/gateway/gateway-new-connection.png)
+1. Hit the "+" button to add a new SSH connection
+   ![Gateway Add Connection](../images/gateway/gateway-add-ssh-configuration.png)
+
+1. For the Host, enter `coder.<workspace name>`
+1. For the Port, enter `22` (this is ignored by Coder)
+1. For the Username, enter `coder`
+1. For the Authentication Type, select "OpenSSH config and authentication
+   agent"
+1. Make sure the checkbox for "Parse config file ~/.ssh/config" is checked.
+1. Click "Test Connection" to validate these settings.
+1. Click "OK"
+   ![Gateway SSH Configuration](../images/gateway/gateway-create-ssh-configuration.png)
+1. Select the connection you just added
+   ![Gateway Welcome](../images/gateway/gateway-welcome.png)
+1. Click "Check Connection and Continue"
+   ![Gateway Continue](../images/gateway/gateway-continue.png)
+1. Select the JetBrains IDE for your project and the project directory.
+   SSH into your server to create a directory or check out code if you haven't already.
+   ![Gateway Choose IDE](../images/gateway/gateway-choose-ide.png)
+   > Note the JetBrains IDE is remotely installed into `~/. cache/JetBrains/RemoteDev/dist`
+1. Click "Download and Start IDE" to connect.
+   ![Gateway IDE Opened](../images/gateway/gateway-intellij-opened.png)
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -83,8 +83,8 @@
           "path": "./ides/configuring-web-ides.md"
         },
         {
-          "title": "Configuring Jetbrains Gateway",
-          "description": "Learn how to configure Jetbrains Gateway for your workspaces",
+          "title": "Configuring JetBrains Gateway",
+          "description": "Learn how to configure JetBrains Gateway for your workspaces",
           "path": "./ides/configuring-gateway.md"
         }
       ]

diff --git a/docs/templates.md b/docs/templates.md
@@ -98,11 +98,7 @@ inherited by all child processes of the agent, including SSH sessions.
 #### startup_script
 
 Use the Coder agent's `startup_script` to run additional commands like
-installing IDEs and clone dotfile and project repos. In this example, the
-project and dotfile repos are specified as Terraform input variables elsewhere
-in the `main.tf` Note the `&` after the `code-server` start to execute
-`code-server` process in the background so the `startup_script` can continue
-with the repo cloning steps.
+installing IDEs, [cloning dotfile](./dotfiles.md#templates), and cloning project repos.
 
 ```hcl
 resource "coder_agent" "coder" {
@@ -113,27 +109,27 @@ resource "coder_agent" "coder" {
 #!/bin/bash
 
 # install code-server
-curl -fsSL https://code-server.dev/install.sh | sh 
+curl -fsSL https://code-server.dev/install.sh | sh
+
+# The & prevents the startup_script from blocking so the
+# next commands can run.
 code-server --auth none --port &
 
+# var.repo and var.dotfiles_uri is specified
+# elsewhere in the Terraform code as input
+# variables.
+
 # clone repo
 ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
 git clone --progress git@github.com:${var.repo}
 
 # use coder CLI to clone and install dotfiles
 coder dotfiles -y ${var.dotfiles_uri}
 
-  EOT  
+  EOT
 }
 ```
 
-#### Logging
-
-The output of the `startup_script` are located in
-`/tmp/coder-startup-script.log` within the workspace.
-
-The Coder agent log is located in `/tmp/coder-agent.log` within the workspace.
-
 ### Parameters
 
 Templates often contain _parameters_. These are defined by `variable` blocks in

diff --git a/docs/workspaces.md b/docs/workspaces.md
@@ -49,6 +49,15 @@ The workspace will be stopped and started:
 coder update <workspace-name>
 ```
 
+## Logging
+
+Coder stores MacOS and Linux logs at the following locations:
+
+| Service          | Location                        |
+| ---------------- | ------------------------------- |
+| `startup_script` | `/tmp/coder-startup-script.log` |
+| Agent            | `/tmp/coder-agent.log`          |
+
 ---
 
 ## Up next