fleshed out vscode page

stirby · matifali · commit 0cc2d324bd0a · 2024-08-12T17:01:25.000+03:00
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -87,8 +87,8 @@
           "path": "./user-guides/workspace-access/README.md",
           "children": [
             {
-              "title": "VSCode Desktop",
-              "description": "Use VSCode desktop with Coder",
+              "title": "Visual Studio Code",
+              "description": "Use VSCode with Coder in the desktop or browser",
               "path": "./user-guides/workspace-access/vscode.md"
             },
             {
diff --git a/docs/user-guides/workspace-access/README.md b/docs/user-guides/workspace-access/README.md
@@ -63,18 +63,12 @@ Your workspace is now accessible via `ssh coder.<workspace_name>` (e.g.,
 
 ## Visual Studio Code
 
-Click `VS Code Desktop` in the dashboard to one-click enter a workspace. This
-automatically installs the [Coder Remote](https://github.com/coder/vscode-coder)
-extension, authenticates with Coder, and connects to the workspace.
+You can develop in your Coder workspace remotely with
+[VSCode](https://code.visualstudio.com/download). We support connecting with the desktop client and VSCode in the browser with [code-server](#code-server).
 
 ![Demo](https://github.com/coder/vscode-coder/raw/main/demo.gif?raw=true)
 
-You can set the default directory in which VS Code opens via the `dir` argument
-on the `coder_agent` resource in your workspace template. See the
-[Terraform documentation for more details](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent#dir).
-
-> The `VS Code Desktop` button can be hidden by enabling
-> [Browser-only connections](./networking/index.md#Browser-only).
+Read more details on [using VSCode in your workspace](./vscode.md). 
 
 ### Manual Installation
 
diff --git a/docs/user-guides/workspace-access/vscode.md b/docs/user-guides/workspace-access/vscode.md
@@ -1,7 +1,11 @@
 # Visual Studio Code
 
 You can develop in your Coder workspace remotely with
-[VSCode desktop](https://code.visualstudio.com/download).
+[VSCode](https://code.visualstudio.com/download). We support connecting with the desktop client and VSCode in the browser with [code-server](#code-server). 
+
+## VSCode Desktop
+
+VSCode desktop is a default Coder App for agents.
 
 Click `VS Code Desktop` in the dashboard to one-click enter a workspace. This
 automatically installs the [Coder Remote](https://github.com/coder/vscode-coder)
@@ -15,3 +19,22 @@ on the `coder_agent` resource in your workspace template. See the
 
 > The `VS Code Desktop` button can be hidden by enabling
 > [Browser-only connections](./networking/index.md#Browser-only).
+
+### Manual Installation
+
+You can install our extension manually in VSCode using the command pallette. Launch VS Code Quick Open (Ctrl+P), paste the following command, and press
+enter.
+
+```text
+ext install coder.coder-remote
+```
+
+Alternatively, manually install the VSIX from the
+[latest release](https://github.com/coder/vscode-coder/releases/latest).
+
+## code-server
+
+[code-server](https://github.com/coder/code-server) is our supported method of running
+VS Code in the web browser. You can read more in our [documentation for code-server](https://coder.com/docs/code-server/latest).
+
+![code-server in a workspace](../../images/code-server-ide.png)

Original file line number	Diff line number	Diff line change
`@@ -87,8 +87,8 @@`
`87`	`87`	`"path": "./user-guides/workspace-access/README.md",`
`88`	`88`	`"children": [`
`89`	`89`	`{`
`90`		`- "title": "VSCode Desktop",`
`91`		`- "description": "Use VSCode desktop with Coder",`
	`90`	`+ "title": "Visual Studio Code",`
	`91`	`+ "description": "Use VSCode with Coder in the desktop or browser",`
`92`	`92`	`"path": "./user-guides/workspace-access/vscode.md"`
`93`	`93`	`},`
`94`	`94`	`{`