consistent examples

EdwardAngert · EdwardAngert · commit 1dda50d2a5b9 · 2025-07-29T04:09:32.000Z
diff --git a/docs/user-guides/devcontainers/index.md b/docs/user-guides/devcontainers/index.md
@@ -41,13 +41,19 @@ When a workspace with the dev containers integration starts:
 
 ### Connectivity
 
-- Full SSH access directly into dev containers
+- Full SSH access directly into dev containers (after running `coder config-ssh`):
 
    ```shell
-   ssh <agent>.<workspace>.me.coder
+   ssh <agent>.<workspace-name>.me.coder
    ```
 
-- Automatic port forwarding.
+   Example:
+
+   ```shell
+   ssh devcontainer.myworkspace.me.coder
+   ```
+
+- Support for ports defined in the `appPort` property of your `devcontainer.json` file.
 
 ## Known Limitations
 
diff --git a/docs/user-guides/devcontainers/working-with-dev-containers.md b/docs/user-guides/devcontainers/working-with-dev-containers.md
@@ -13,25 +13,25 @@ You can connect directly to your dev container.
 
 1. Run `coder config-ssh` to configure your SSH local client:
 
-   ```bash
+   ```shell
     coder config-ssh
     ```
 
 1. SSH to your workspace:
 
-    ```bash
+    ```shell
     ssh <agent>.<workspace-name>.me.coder
     ```
 
    Example:
 
-    ```bash
+    ```shell
     ssh devcontainer.myworkspace.me.coder
     ```
 
 ### Coder CLI
 
-```bash
+```shell
 coder ssh <workspace-name>
 ```
 
@@ -50,7 +50,7 @@ To open your dev container directly in VS Code, select "Open in VS Code Desktop"
 
 Alternatively, you can use the CLI:
 
-```bash
+```shell
 coder open vscode <workspace-name>
 ```
 
@@ -64,7 +64,7 @@ Coder supports port forwarding for dev containers through the following mechanis
 
 1. **Dynamic Ports**: For ports not defined in your `devcontainer.json`, you can use the Coder CLI to forward them:
 
-   ```bash
+   ```shell
    coder port-forward <workspace-name> --tcp <local-port>:<container-port>
    ```
 
@@ -78,7 +78,7 @@ For example, with this `devcontainer.json` configuration:
 
 You can access these ports directly through your browser via the Coder dashboard, or forward them to your local machine:
 
-```bash
+```shell
 coder port-forward <workspace-name> --tcp 8080,4000
 ```
 
