coder · khorne3 · Jun 16, 2022 · Jun 15, 2022 · Jun 15, 2022 · Jun 15, 2022
diff --git a/docs/ides.md b/docs/ides.md
@@ -0,0 +1,55 @@
+# IDEs
+
+The following desktop IDEs have been tested with Coder, though any IDE with SSH
+support should work:
+
+- VS Code (with [Remote -
+  SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh)
+  extension)
+- JetBrains (with
+  [Gateway](https://www.jetbrains.com/help/idea/remote-development-a.html#launch_gateway)
+  installed)
+  - IntelliJ IDEA
+  - CLion
+  - GoLand
+  - PyCharm
+  - Rider
+  - RubyMine
+  - WebStorm
+
+## SSH configuration
+
+To access Coder via SSH, run the following in the terminal:
+
+```console
+coder config-ssh
+```
+
+> Run `coder config-ssh --diff` if you'd like to see the changes that will be
+> made before proceeding.
+
+Confirm that you would like to continue by typing **yes** and pressing enter. If
+successful, you'll see the following message:
+
+```console
+You should now be able to ssh into your workspace.
+For example, try running:
+
+$ ssh coder.<workspaceName>
+```
+
+Your workspace is now accessible via `ssh coder.<workspace_name>` (e.g.,
+`ssh coder.myEnv` if your workspace is named `myEnv`).
+
+## VS Code
+
+Once you've configured SSH, you can work on projects from your local copy of VS
+Code, connected to your Coder workspace for compute, etc.
+
+1. Open VS Code locally.
+
+1. Install the [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh)
+   extension.
+
+1. In VS Code's left-hand nav bar, click **Remote Explorer** and right-click on
+   a workspace to connect.
diff --git a/docs/index.md b/docs/index.md
@@ -21,3 +21,4 @@
   - [Editors and IDEs](./workspaces.md#editors-and-ides)
   - [Workspace lifecycle](./workspaces.md#workspace-lifecycle)
   - [Updating workspaces](./workspaces.md#updating-workspaces)
+- [IDEs](./ides.md)
diff --git a/docs/workspaces.md b/docs/workspaces.md
@@ -10,40 +10,15 @@ templates](./templates.md):
 
 ```sh
 # create a workspace from the template; specify any variables
-coder create <workspace-name>
+create --template="<templateName>" <workspaceName>
 
 # show the resources behind the workspace and how to connect
 coder show <workspace-name>
 ```
 
-## Connect with SSH
+## IDEs
 
-Once you've added your workspaces to your SSH hosts, you can connect from any
-IDE with remote development support:
-
-```sh
-coder config-ssh
-coder ssh <workspaceName>
-```
-
-## Editors and IDEs
-
-The following desktop IDEs have been tested with Coder, though any IDE with SSH
-support should work!
-
-- VS Code (with [Remote -
-  SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh)
-  extension)
-- JetBrains (with
-  [Gateway](https://www.jetbrains.com/help/idea/remote-development-a.html#launch_gateway)
-  installed)
-  - IntelliJ IDEA
-  - CLion
-  - GoLand
-  - PyCharm
-  - Rider
-  - RubyMine
-  - WebStorm
+Coder [supports multiple IDEs](ides.md) for use with your workspaces.
 
 ## Workspace lifecycle
 
@@ -67,8 +42,10 @@ When a workspace is deleted, all of the workspace's resources are deleted.
 
 ## Dotfiles
 
-Users can install configuration from a personal [dotfiles repository](https://dotfiles.github.io) with the `coder dotfiles <repo>`
-command in their workspace. Templates can also prompt users for their dotfiles repo [(example)](../examples/templates/docker-with-dotfiles/README.md#how-it-works).
+Users can install configuration from a personal [dotfiles
+repository](https://dotfiles.github.io) with the `coder dotfiles <repo>` command
+in their workspace. Templates can also prompt users for their dotfiles repo
+[(example)](../examples/templates/docker-with-dotfiles/README.md#how-it-works).
 
 ## Updating workspaces