Skip to content

Commit d1f212b

Browse files
committed
Removed mention of forcing extn to UI in user docs given no good example exists
1 parent e6f14e2 commit d1f212b

File tree

3 files changed

+15
-15
lines changed

3 files changed

+15
-15
lines changed

docs/remote/containers.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -234,18 +234,18 @@ If there are extensions that you would like always installed in any container, y
234234
235235
### Advanced: Forcing an extension to run locally / remotely
236236
237-
As mentioned, VS Code runs extensions in either the local client or the container remote host. Extensions typically are designed and tested for use in one side or the other, not both. However, you can force an extension to run in a particular location in your User [settings](/docs/getstarted/settings.md).
237+
Extensions are typically designed and tested to either run locally or remotely, not both. However, if an extension supports it, you can force it to run in a particular location in your `settings.json` file.
238238
239-
For example, the `remote.extensionKind` setting below will force the Azure Cosmos DB extension on the UI side (instead of its Workspace default) and the Debugger for Chrome on the Workspace side (instead of its UI default):
239+
For example, the setting below will force the Docker and Debugger for Chrome extensions to run remotely instead of their local defaults:
240240
241241
```json
242242
"remote.extensionKind": {
243-
"ms-azuretools.vscode-cosmosdb": "ui",
244-
"msjsdiag.debugger-for-chrome": "workspace"
243+
"msjsdiag.debugger-for-chrome": "workspace",
244+
"peterjausovec.vscode-docker": "workspace"
245245
}
246246
```
247247
248-
Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
248+
A value of `"ui"` instead of `"workspace"` will force the extension to run on the local UI/client side instead. Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
249249

250250
## Forwarding a port
251251

docs/remote/ssh.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -105,18 +105,18 @@ If there are extensions that you would like to always have installed on any SSH
105105

106106
### Advanced: Forcing an extension to run locally / remotely
107107

108-
Extensions are typically designed and tested for use in one side or the other, not both. However, you can force an extension to run in a particular location in your `settings.json` file.
108+
Extensions are typically designed and tested to either run locally or remotely, not both. However, if an extension supports it, you can force it to run in a particular location in your `settings.json` file.
109109

110-
For example, the setting below will force the Azure Cosmos DB extension on the UI side (instead of its Workspace default) and the Debugger for Chrome on the Workspace side (instead of its UI default):
110+
For example, the setting below will force the Docker and Debugger for Chrome extensions to run remotely instead of their local defaults:
111111

112112
```json
113113
"remote.extensionKind": {
114-
"ms-azuretools.vscode-cosmosdb": "ui",
115-
"msjsdiag.debugger-for-chrome": "workspace"
114+
"msjsdiag.debugger-for-chrome": "workspace",
115+
"peterjausovec.vscode-docker": "workspace"
116116
}
117117
```
118118

119-
Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
119+
A value of `"ui"` instead of `"workspace"` will force the extension to run on the local UI/client side instead. Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
120120

121121
## Forwarding a port / creating SSH tunnel
122122

docs/remote/wsl.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -73,18 +73,18 @@ Local extensions that actually need to run remotely will appear **Disabled** in
7373

7474
### Advanced: Forcing an extension to run locally / remotely
7575

76-
As mentioned, VS Code runs extensions in either the local client or the WSL remote host. Extensions typically are designed and tested for use in one side or the other, not both. However, you can force an extension to run in a particular location in your `settings.json` file.
76+
Extensions are typically designed and tested to either run locally or remotely, not both. However, if an extension supports it, you can force it to run in a particular location in your `settings.json` file.
7777

78-
For example, the setting below will force the Azure Cosmos DB extension on the UI side (instead of its Workspace default) and the Debugger for Chrome on the Workspace side (instead of its UI default):
78+
For example, the setting below will force the Docker and Debugger for Chrome extensions to run remotely instead of their local defaults:
7979

8080
```json
8181
"remote.extensionKind": {
82-
"ms-azuretools.vscode-cosmosdb": "ui",
83-
"msjsdiag.debugger-for-chrome": "workspace"
82+
"msjsdiag.debugger-for-chrome": "workspace",
83+
"peterjausovec.vscode-docker": "workspace"
8484
}
8585
```
8686

87-
Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
87+
A value of `"ui"` instead of `"workspace"` will force the extension to run on the local UI/client side instead. Typically, this should only be used for testing unless otherwise noted in the extension's documentation since it **can break extensions**. See the article on [Supporting Remote Development](/api/advanced-topics/remote-extensions.md) for details.
8888

8989
## Opening a terminal in WSL
9090

0 commit comments

Comments
 (0)