Merge branch 'main' into python-smart-send

cwebster-99 · web-flow · commit 728fb10fad39 · 2024-09-23T15:34:24.000-07:00
diff --git a/api/extension-guides/chat.md b/api/extension-guides/chat.md
@@ -34,7 +34,7 @@ Participants can also contribute *commands*, which are a shorthand notation for
 
 ## Extending GitHub Copilot via GitHub Apps
 
-Alternatively, it is possible to extend GitHub Copilot by creating a GitHub App that contributes a chat participant in the Chat view. A GitHub App is backed by a service and works across all GitHub Copilot surfaces, such as github.com, Visual Studio, or VS Code. On the other hand, GitHub Apps do not have full access to the VS Code API. To extend GitHub Copilot through a GitHub App, you should join the [Copilot Partner Program](https://github.com/features/preview/copilot-partner-program).
+Alternatively, it is possible to extend GitHub Copilot by creating a GitHub App that contributes a chat participant in the Chat view. A GitHub App is backed by a service and works across all GitHub Copilot surfaces, such as github.com, Visual Studio, or VS Code. On the other hand, GitHub Apps do not have full access to the VS Code API. To learn more about extending GitHub Copilot through a GitHub App see the [GitHub documentation](https://docs.github.com/en/copilot/building-copilot-extensions/about-building-copilot-extensions).
 
 
 ## Links
diff --git a/docs/copilot/ai-powered-suggestions.md b/docs/copilot/ai-powered-suggestions.md
@@ -85,7 +85,7 @@ You can configure the font for the inline suggestions with the `setting(editor.i
 
 * Get started with the introductory [Copilot tutorial](/docs/copilot/getting-started-chat.md) to get set up with Copilot in VS Code and experience Copilot hands-on.
 
-* Learn how you can use AI chat conversations with [GitHub Copilot Chat](/docs/copilot/copilot-chat.md).
+* Learn how you can use AI chat conversations with [Copilot Chat](/docs/copilot/copilot-chat.md).
 
 ## Additional resources
 
diff --git a/docs/copilot/copilot-chat.md b/docs/copilot/copilot-chat.md
@@ -20,7 +20,7 @@ Copilot Chat integrates in your developer flow and gives you assistance where yo
 * Use the **Chat view** to have an AI assistant on the side to help you at any time
 * Launch **Quick Chat** to ask a quick question and get back into what you're doing
 
-You can use GitHub Copilot Chat in various scenarios, such as:
+You can use Copilot Chat in various scenarios, such as:
 
 * Answering coding questions on how to best solve a problem
 * Explaining someone else's code and suggest improvements
diff --git a/docs/copilot/faq.md b/docs/copilot/faq.md
@@ -27,7 +27,7 @@ Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/ma
 
 ### My Copilot subscription is not detected in VS Code
 
-- To use GitHub Copilot Chat in Visual Studio Code, you must be signed into Visual Studio Code with the same GitHub ID that has access to GitHub Copilot. If your Copilot subscription is associated with another GitHub account, you might have to sign out of your GitHub account and sign in with another account. Use the **Accounts** menu in the Activity bar for signing out of your current GitHub account.
+- To use Copilot Chat in Visual Studio Code, you must be signed into Visual Studio Code with the same GitHub ID that has access to GitHub Copilot. If your Copilot subscription is associated with another GitHub account, you might have to sign out of your GitHub account and sign in with another account. Use the **Accounts** menu in the Activity bar for signing out of your current GitHub account.
 
 - Verify that your Copilot subscription is still active in [GitHub Copilot settings](https://github.com/settings/copilot).
 
diff --git a/docs/copilot/getting-started-chat.md b/docs/copilot/getting-started-chat.md
@@ -8,7 +8,7 @@ DateApproved: 09/05/2024
 MetaDescription: Get started with AI-powered chat conversations with GitHub Copilot in Visual Studio Code, inline while you're coding, or in a separate chat view.
 MetaSocialImage: images/shared/github-copilot-social.png
 ---
-# Getting started with GitHub Copilot Chat in VS Code
+# Getting started with Copilot Chat in VS Code
 
 This tutorial walks you through using the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension in Visual Studio Code. You use AI-powered chat conversations to help with refactoring code, improving your code understanding, and finding your way around configuring VS Code.
 
@@ -24,7 +24,7 @@ Follow these steps to [set up GitHub Copilot in VS Code](/docs/copilot/setup.md)
 
 ## Get your first Copilot chat conversation
 
-GitHub Copilot Chat is a chat interface that lets you interact with GitHub Copilot, to ask and receive answers to coding-related questions. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums.
+Copilot Chat is a chat interface that lets you interact with GitHub Copilot, to ask and receive answers to coding-related questions. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums.
 
 In this tutorial, you'll be creating a simple Node.js web application. So, let's get started and ask Copilot to tell us more about web frameworks for Node.js.
 
@@ -208,5 +208,5 @@ Congratulations, you successfully used the [GitHub Copilot Chat](https://marketp
 
 ## Additional resources
 
-* Get an overview of [GitHub Copilot Chat in VS Code](/docs/copilot/copilot-chat.md)
+* Get an overview of [Copilot Chat in VS Code](/docs/copilot/copilot-chat.md)
 * Optimize your Copilot experience with [prompt crafting and context setting](/docs/copilot/prompt-crafting.md)
diff --git a/docs/copilot/getting-started.md b/docs/copilot/getting-started.md
@@ -86,7 +86,7 @@ Let's use Copilot Chat to help us with generating and refactoring code.
 
 1. Select **Accept** or press `kb(inlineChat.acceptChanges)` to apply the proposed code changes.
 
-    Congratulations! You've used GitHub Copilot Chat for generating code using chat and natural language.
+    Congratulations! You've used Copilot Chat for generating code using chat and natural language.
 
     Now, let's use Copilot Chat to help us refactor the code to return a static HTML file as the home page, instead of "Hello, World!".
 
@@ -108,7 +108,7 @@ With Copilot Chat you can use a chat conversation and natural language to direct
 
 ## Use Copilot Chat for general programming questions
 
-As you're working in a new codebase, or exploring a new programming language, you might have more general questions come up. GitHub Copilot Chat lets you open a chat conversation on the side, and which keeps track of the history of your questions.
+As you're working in a new codebase, or exploring a new programming language, you might have more general questions come up. Copilot Chat lets you open a chat conversation on the side, and which keeps track of the history of your questions.
 
 1. Open the Chat view from the Activity Bar or press `kb(workbench.action.chat.open)`.
 
@@ -152,4 +152,4 @@ One such place is the Copilot coding actions in the editor, whenever there you h
 
 Congratulations, you've now used artificial intelligence to enhance your coding! In this tutorial, you successfully set up Copilot in VS Code, and used Copilot code completions, Copilot Chat, and code actions to help you code more efficiently.
 
-You've started experimenting with Copilot and there's a lot more you can do with it! To learn more about GitHub Copilot Chat, proceed to the [Copilot Chat Tutorial](/docs/copilot/getting-started-chat.md).
+You've started experimenting with Copilot and there's a lot more you can do with it! To learn more about Copilot Chat, proceed to the [Copilot Chat Tutorial](/docs/copilot/getting-started-chat.md).
diff --git a/docs/copilot/workspace-context.md b/docs/copilot/workspace-context.md
@@ -74,5 +74,5 @@ The way you phrase your question can significantly influence the quality of the
 
 ## Related resources
 
-- Get started with the [GitHub Copilot Chat tutorial](/docs/copilot/getting-started-chat.md)
+- Get started with the [Copilot Chat tutorial](/docs/copilot/getting-started-chat.md)
 - [Use the Chat Participant API to build a chat extension](/api/extension-guides/chat.md)
diff --git a/docs/datascience/data-science-tutorial.md b/docs/datascience/data-science-tutorial.md
@@ -20,7 +20,7 @@ The following installations are required for the completion of this tutorial. Ma
 - [Visual Studio Code](https://code.visualstudio.com/)
 - The [Python extension for VS Code](https://marketplace.visualstudio.com/items?itemName=ms-python.python) and [Jupyter extension for VS Code](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter) from the Visual Studio Marketplace. For more details on installing extensions, see [Extension Marketplace](/docs/editor/extension-marketplace.md). Both extensions are published by Microsoft.
 
-- [Miniconda with latest Python](https://docs.conda.io/en/latest/miniconda.html)
+- [Miniconda with latest Python](https://docs.anaconda.com/miniconda/)
 
    > **Note**: If you already have the full Anaconda distribution installed, you don't need to install Miniconda. Alternatively, if you'd prefer not to use Anaconda or Miniconda, you can create a Python virtual environment and install the packages needed for the tutorial using pip. If you go this route, you will need to install the following packages: pandas, jupyter, seaborn, scikit-learn, keras, and tensorflow.
 
diff --git a/docs/editor/settings-sync.md b/docs/editor/settings-sync.md
@@ -195,6 +195,11 @@ It's possible that your wallet (aka keyring) is closed. If you open [KWalletMana
 
 If you are using KDE5 or higher and are having trouble connecting to `kwallet5` (like users of the unofficial VS Code Flatpak in [issue #189672](https://github.com/microsoft/vscode/issues/189672)), you can try [configuring the keyring](#other-linux-desktop-environments) to `gnome-libsecret` as this will use the [Secret Service API](https://www.gnu.org/software/emacs/manual/html_node/auth/Secret-Service-API.html) to communicate with any valid keyring. `kwallet5` implements the Secret Service API and can be accessed using this method.
 
+If you're still experiencing trouble connecting to `kwallet5`, some users have reported that granting the specific D-Bus service permissions proved a viable fix:
+```sh
+flatpak override --user --talk-name=org.kde.kwalletd5 --talk-name=org.freedesktop.secrets com.visualstudio.code
+```
+
 #### Other Linux desktop environments
 
 First off, if your desktop environment wasn't detected, you can [open an issue on VS Code](https://github.com/microsoft/vscode/issues/new/choose) with the verbose logs from above. This is important for us to support additional desktop configurations.
diff --git a/docs/editor/voice.md b/docs/editor/voice.md
@@ -1,15 +1,15 @@
 ---
 Order: 24
 Area: editor
-TOCTitle: Voice interactions
+TOCTitle: Voice Interactions
 ContentId: e3bf9098-7b2f-4b23-9e0f-3d2094bad80a
 PageTitle: Using Voice in Visual Studio Code
 DateApproved:
 MetaDescription: Visual Studio Code voice accessibility features. Learn here about the various ways VS Code can be used with voice.
 ---
 # Voice Support
 
-The [VS Code Speech](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-speech) extension enables various features by using your voice. Once installed, the extension enables you to dictate into the editor, or to verbally interact with [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat).
+The [VS Code Speech](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-speech) extension enables various features by using your voice. Once installed, the extension enables you to dictate into the editor, or to verbally interact with [Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat).
 
 ![Screenshot of the VS Code Speech extension marketplace details](images/accessibility/speech-extension.png)
 
@@ -25,13 +25,13 @@ You can press and hold the keybinding for the voice start command (`kb(workbench
 
 **Note:** dictation even works in other places where a rich editor is used, such as the SCM commit input box and the comments input field when reviewing pull requests.
 
-## Voice in GitHub Copilot Chat
+## Voice in Copilot Chat
 
-You can use your voice to talk to [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) easily. The command **Voice: Start Voice Chat** (`kb(workbench.action.chat.startVoiceChat)`) brings up a voice chat, regardless of where the current focus is. If the focus is in the editor, inline chat is started, otherwise the Chat view is opened.
+You can use your voice to talk to [Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) easily. The command **Voice: Start Voice Chat** (`kb(workbench.action.chat.startVoiceChat)`) brings up a voice chat, regardless of where the current focus is. If the focus is in the editor, inline chat is started, otherwise the Chat view is opened.
 
 ![Screenshot of the chat input field showing an active microphone icon to enter a voice chat message](images/accessibility/voice-chat.png)
 
-**Note:** when using voice for GitHub Copilot Chat, the chat prompt will automatically submit when you pause. You can configure the time to wait before submitting via the `setting(accessibility.voice.speechTimeout)` setting, or disable this functionality when you configure the setting to `0`.
+**Note:** when using voice for Copilot Chat, the chat prompt will automatically submit when you pause. You can configure the time to wait before submitting via the `setting(accessibility.voice.speechTimeout)` setting, or disable this functionality when you configure the setting to `0`.
 
 Copilot Chat also supports text-to-speech capabilities. When you enable the `setting(accessibility.voice.autoSynthesize)` setting, Copilot Chat responses are automatically read out aloud when voice was also used as input. To interrupt the synthesis, select the icon or press `kb(workbench.action.speech.stopReadAloud)`.
 
diff --git a/docs/getstarted/userinterface.md b/docs/getstarted/userinterface.md
@@ -7,13 +7,13 @@ PageTitle: Visual Studio Code User Interface
 DateApproved: 09/05/2024
 MetaDescription: A quick overview of the Visual Studio Code user interface. Learn about the editor, window management, and special UI to handle source control, extension management, full text search and more.
 ---
-# User Interface
+# User interface
 
 At its heart, Visual Studio Code is a code editor. Like many other code editors, VS Code adopts a common user interface and layout of an explorer on the left, showing all of the files and folders you have access to, and an editor on the right, showing the content of the files you have opened.
 
-![Screenshot of the VS Code user interface, highlighting the five main areas.](images/userinterface/hero.png)
+<iframe width="560" height="315" src="https://www.youtube.com/embed/nORT3-kONgA" title="Transform your VS Code user interface" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
 
-## Basic Layout
+## Basic layout
 
 VS Code comes with a simple and intuitive layout that maximizes the space provided for the editor, while leaving ample room to browse and access the full context of your folder or project. The user interface is divided into five main areas:
 
@@ -23,6 +23,8 @@ VS Code comes with a simple and intuitive layout that maximizes the space provid
 * **Activity Bar** -  Located on the far left-hand side. Lets you switch between views and gives you additional context-specific indicators, like the number of outgoing changes when Git is enabled. You can change the position of the Activity Bar.
 * **Panel** - An additional space for views below the editor region. By default, it contains output, debug information, errors and warnings, and an integrated terminal. The Panel can also be moved to the left or right for more vertical space.
 
+![Screenshot of the VS Code user interface, highlighting the five main areas.](images/userinterface/hero.png)
+
 >**Tip:** A Secondary Side Bar is also available to display views opposite the Primary Side Bar. You can show it with `kb(workbench.action.toggleAuxiliaryBar)` and drag a view from the Primary Side Bar to the Secondary Side Bar.
 
 Each time you start VS Code, it opens up in the same state it was in when you last closed it. The folder, layout, and opened files are preserved.
@@ -31,7 +33,7 @@ Open files in each editor are displayed with tabbed headers (Tabs) at the top of
 
 >**Tip:** You can move the Primary Side Bar to the right hand side by right-clicking the Activity Bar and selecting **Move Primary Side Bar Right** or toggle its visibility (`kb(workbench.action.toggleSidebarVisibility)`).
 
-## Side by Side Editing
+## Side by side editing
 
 You can open as many editors as you like side by side vertically and horizontally. If you already have an editor open, there are multiple ways of opening another editor to the side:
 
@@ -52,7 +54,7 @@ When you have more than one editor open, you can switch between them quickly by
 
 >**Tip:** You can resize editors and reorder them. Drag and drop the editor title area to reposition or resize the editor.
 
-### Editor Groups
+### Editor groups
 
 When you split an editor (using the **Split Editor** or **Open to the Side** commands), a new editor region (edit group) is created which can hold a group of items. You can open as many editor groups as you like side by side vertically and horizontally.
 
@@ -68,7 +70,7 @@ You can drag and drop editor groups on the workbench, move individual tabs betwe
 
 You can split the current editor without creating a new editor group with the **View: Split Editor in Group** command (`kb(workbench.action.splitEditorInGroup)`). To learn more about this editor mode and specific commands for navigating between the two sides, you can read the section in the [Custom Layout](/docs/editor/custom-layout.md#split-in-group) article.
 
-### Floating Windows
+### Floating windows
 
 You can move editors into their own floating windows with the **Move into New Window** or **Copy into New Window** (`kb(workbench.action.copyEditorToNewWindow)`) commands. To learn more about floating editor windows, you can read the section in the [Custom Layout](/docs/editor/custom-layout.md#floating-editor-windows) article.
 
@@ -92,7 +94,7 @@ Sticky Scroll shows the starting lines of currently visible nested scopes at the
 
 Sticky Scroll uses several different content models to create its headings. It is possible to choose between the outline provider model, the folding provider model, and the indentation model to determine which lines to display in the Sticky Scroll area. If a model is not available for the current language, VS Code falls back to the next model in the  order given above. The default model initially used comes from the `setting(editor.stickyScroll.defaultModel)` setting.
 
-### Indent Guides
+### Indent guides
 
 The editor shows indentation guides (vertical lines) which help you quickly see matching indent levels. If you would like to disable indent guides, you can set `"editor.guides.indentation": false` in your user or workspace [settings](/docs/getstarted/settings.md).
 
@@ -233,7 +235,7 @@ Zen Mode can be further tuned with the following settings:
 * `setting(zenMode.centerLayout)` - Use [Centered editor layout](#centered-editor-layout). Default `true`.
 * `setting(zenMode.silentNotifications)` - Do not display notifications. Default `true`.
 
-### Centered Editor Layout
+### Centered editor layout
 
 Centered editor layout allows you to center align the editor area. This is useful when working with a single editor on a large monitor. You can use the side borders to resize the view (hold down the `Alt` key to independently move the sides).
 
diff --git a/docs/languages/ruby.md b/docs/languages/ruby.md
