diff --git a/src/content/docs/references/ides-and-editors/settings-sync.md b/src/content/docs/references/ides-and-editors/settings-sync.md index dedf4cc977..53a65c5a75 100644 --- a/src/content/docs/references/ides-and-editors/settings-sync.md +++ b/src/content/docs/references/ides-and-editors/settings-sync.md @@ -28,7 +28,7 @@ The following settings are synced via Settings Sync: ## Gitpod vs Microsoft Settings Sync -By default, most desktop VS Code installations are configured to sync settings via a GitHub or a Microsoft account. These settings are synced to Microsoft's servers and are inaccessible to third-parties, including Gitpod. Due to this limitation of access to settings stored in Microsoft servers, Gitpod implements its own VS Code settings sync server. Gitpod **Settings Sync is enabled by default for VS Code in the browser, but must be configured for desktop**. +By default, most desktop VS Code installations are configured to sync settings via a GitHub or a Microsoft account. These settings are synced to Microsoft's servers and are inaccessible to third-parties, including Gitpod. Due to this limitation of access to settings stored in Microsoft servers, Gitpod implements its own VS Code settings sync server. Gitpod **Settings Sync is enabled by default for VS Code in the browser**. ### Enabling Settings Sync in VS Code Browser @@ -36,56 +36,9 @@ VS Code in the browser with Gitpod has Settings Sync enabled by default, syncing ### Enabling Settings Sync in VS Code Desktop -> **Notice:** As of version 1.81, Settings Sync in VS Code is experiencing issues, due to [an unanticipated change in the upstream VS Code API](https://github.com/microsoft/vscode/pull/187006). Whilst the issue is resolved, we recommend using an earlier version of VS Code, such as [1.80.2](https://code.visualstudio.com/updates/v1_80). For updates or feedback, see this issue: [#18573](https://github.com/gitpod-io/gitpod/issues/18573). +For enabling setting sync in VS Code Desktop please refer to the [official VS Code Settings Sync documentation](https://code.visualstudio.com/docs/editor/settings-sync) -1. Install and enable the [Gitpod extension](https://marketplace.visualstudio.com/items?itemName=gitpod.gitpod-desktop). - -**Note:** If you open VS Code Desktop directly from Gitpod, the Gitpod extension is automatically installed for you. - -
-The Gitpod VS Code Desktop plugin -
The Gitpod VS Code Desktop plugin
-
- -2. Using the [Command Palette](https://code.visualstudio.com/api/ux-guidelines/command-palette) select: "Settings Sync: Enable signing in with Gitpod". - -![Enable Settings Sync with Gitpod](/images/editors/enable-signin-with-gitpod-light-theme.png) -![Enable Settings Sync with Gitpod](/images/editors/enable-signin-with-gitpod-dark-theme.png) -_Enable Settings Sync with Gitpod_ - -3. Restart your VS Code Desktop application. - -
-Prompt to restart VS Code Desktop -
Prompt to restart VS Code Desktop
-
- -> **Important:** You must entirely close VS Code Desktop for changes to take effect. - -4. Enable settings sync from the Manage gear menu at the bottom of the Activity Bar. - -You must authenticate with Gitpod to enable settings sync. - -
-Enable settings sync from the Manage gear menu -
Enable settings sync from the Manage gear menu
-
- -You will be prompted which settings to sync, and to authenticate via Gitpod. - -
-Sign into Gitpod to enable VS Code settings sync -
Sign into Gitpod to enable VS Code settings sync
-
- -5. Resolve any settings conflicts - -Settings in VS Code Desktop might differ from your remote settings, follow the instructions in VS Code to resolve any conflicts with the preferences files. - -
-Merge or replace VS Code Settings -
Merge or replace VS Code Settings
-
+> **Notice:** Syncing between VS Code Browser and VS Code Desktop is not supported. ## FAQs diff --git a/src/content/docs/references/ides-and-editors/vscode.md b/src/content/docs/references/ides-and-editors/vscode.md index d35b52ba4e..3a92c366cb 100644 --- a/src/content/docs/references/ides-and-editors/vscode.md +++ b/src/content/docs/references/ides-and-editors/vscode.md @@ -112,11 +112,9 @@ _The open workspace button shown on a stopped workspace page_ ## VS Code settings sync -You can optionally enable Settings Sync with Gitpod to keep your extensions, themes and settings up-to-date with VS Code Browser and Desktop. See [VS Code settings sync](settings-sync) for more +For enabling Setting Sync in VS Code Desktop please refer to the [official VS Code Settings Sync documentation](https://code.visualstudio.com/docs/editor/settings-sync) -![Enable Settings Sync with Gitpod](/images/editors/enable-signin-with-gitpod-light-theme.png) -![Enable Settings Sync with Gitpod](/images/editors/enable-signin-with-gitpod-dark-theme.png) -_Enable Settings Sync with Gitpod_ +> **Notice:** Syncing between VS Code Browser and VS Code Desktop is not supported. ## Managing VS Code extensions