Update Chat for 1.96

Author: ntrogh

docs/copilot/copilot-chat.md

@@ -18,6 +18,9 @@ Copilot Chat integrates in your developer flow and gives you assistance where yo
 * [**Chat view**](#chat-view): have an AI assistant on the side to help with your questions and to provide code suggestions
 * [**Quick Chat**](#quick-chat): ask a quick question and get back into what you're doing
 
+> [!TIP]
+> If you intend to make edits across multiple files in your project, you might consider using [Copilot Edits](/docs/copilot/copilot-edits.md). You can easily [move an existing chat conversation to Copilot Edits](/docs/copilot/copilot-edits.md#send-a-chat-request-to-copilot-edits).
+
 ## Copilot Chat use cases
 
 You can use Copilot Chat in various developer scenarios, such as:
@@ -37,7 +40,7 @@ You can use Copilot Chat in various developer scenarios, such as:
 
 Follow these steps to [set up GitHub Copilot in VS Code](/docs/copilot/setup.md) by signing up for a subscription and installing the Copilot extension in VS Code.
 
-## Getting started
+## Getting started with Copilot Chat
 
 ### Open chat
 
@@ -57,24 +60,35 @@ Or use one of the keyboard shortcuts to start a chat conversation with Copilot.
 
 Copilot tries to determine the intent and scope of your question based on your natural language chat prompt. To help Copilot give you the best and most relevant answers, add context to your chat prompt. For example, attach specific files or even the full contents of your workspace, the current editor selection, and more.
 
-You can add context to your chat message by using the <i class="codicon codicon-attach"></i> button (`kb(workbench.action.chat.attachContext)`) in any of the chat experiences. You can then select the specific type of context from a Quick Pick, such as the current selection, one or more files from the workspace, or one or more symbols from your source code.
+VS Code automatically adds the currently active editor as context to your chat prompt in the Chat view. If you have a block of code selected in the editor, only that selection is added as context. You can disable adding the active editor by selecting the disable icon on the context item.
 
-![Screenshot of VS Code Copilot Chat view, showing the Attach context button and context Quick Pick.](./images/copilot-chat/copilot-chat-view-attach-context.png)
+![Screenshot of VS Code Copilot Chat view, showing the current editor selection as context.](./images/copilot-chat/copilot-chat-view-selection-context.png)
 
-> [!TIP]
-> To quickly add multiple items from the attachment Quick Pick, use the `kbstyle(Up)` and `kbstyle(Down)` keys to navigate the list, use the `kbstyle(Right)` key to add the item as context, and then repeat this for other items.
+There are several ways to add context to your chat prompt:
 
-Another quick way to add specific files to your chat prompt is to drag and drop files from the Explorer or Search view onto the chat input field. You can also drag and drop an editor tab onto the chat input field to add the file as context.
+* Use the <i class="codicon codicon-attach"></i> button (`kb(workbench.action.chat.attachContext)`) in any of the chat experiences.
 
-<video src="images/copilot-chat/copilot-attach-dnd.mp4" title="Dragging files and editors into chat" autoplay loop controls muted></video>
+    You can then select the specific type of context from a Quick Pick, such as the current selection, one or more files from the workspace, or one or more symbols from your source code.
 
-VS Code automatically adds the currently active editor as context to your chat prompt in the Chat view. If you have a block of code selected in the editor, only that selection is added as context. You can disable adding the active editor by selecting the disable icon on the context item.
+    ![Screenshot of VS Code Copilot Chat view, showing the Attach context button and context Quick Pick.](./images/copilot-chat/copilot-chat-view-attach-context.png)
 
-![Screenshot of VS Code Copilot Chat view, showing the current editor selection as context.](./images/copilot-chat/copilot-chat-view-selection-context.png)
+    > [!TIP]
+    > To quickly add multiple items from the attachment Quick Pick, use the `kbstyle(Up)` and `kbstyle(Down)` keys to navigate the list, use the `kbstyle(Right)` key to add the item as context, and then repeat this for other items.
 
-You can also reference context by using chat variables. Type the `#` character and you'll see a list of available chat variables. For example, you can use `#selection` to add the current editor selection to your chat prompt, or `#file` to add a specific file from the workspace.
+* Drag and drop editor tabs, or files or folders from the Explorer view, Search view, or editor breadcrumb onto the Chat view.
 
-![Screenshot of VS Code Copilot Chat view, showing the chat variable picker.](./images/copilot-chat/copilot-chat-view-chat-variables.png)
+    <video src="images/copilot-chat/copilot-attach-dnd.mp4" title="Dragging files and editors into chat" autoplay loop controls muted></video>
+
+* Use chat variables by typing the `#` character and you'll see a list of available chat variables.
+
+    For example, you can use `#selection` to add the current editor selection to your chat prompt, `#file` to add a specific file from the workspace, or `#sym` to add a symbol from the workspace.
+
+    ![Screenshot of VS Code Copilot Chat view, showing the chat variable picker.](./images/copilot-chat/copilot-chat-view-chat-variables.png)
+
+    > [!TIP]
+    > Type `#` and use it as an IntelliSense trigger for file or symbol suggestions.
+
+* Use the context menu **Copilot** > **Add File to Chat** (or **Add Selection to Chat** for a text selection) on a file in the Explorer or Search view.
 
 > [!NOTE]
 > If possible, the full contents of the file will be included when you attach a file. If that is too large to fit into the context window, an outline of the file will be included that includes functions and their descriptions without implementations. If the outline is also too large, then the file won't be part of the prompt.
@@ -219,22 +233,26 @@ Once a command is suggested, use **Run** (`kb(workbench.action.terminal.chat.run
 
 Optionally, you can edit the command directly in the Copilot response before running it by placing the cursor in the response or by pressing `kbstyle(Ctrl+down)`, `kbstyle(Tab)`, `kbstyle(Tab)` on Windows & Linux, or `kbstyle(Cmd+down)`, `kbstyle(Tab)`, `kbstyle(Tab)` on macOS.
 
-## Chat smart actions
+## Smart actions
+
+Copilot Chat lets you use natural language to get help from Copilot. For several common scenarios, you can use *smart actions* to get help from Copilot without having to write a prompt. Examples of these smart actions are for tasks, such as generating commit messages, generating documentation, fixing code, explaining code, or reviewing code changes.
 
-To make it easier to use Copilot Chat features, smart actions are integrated in your VS Code flow and they do not require you to write any prompt at all. For example, you can access Copilot smart actions from the editor context menu or through Quick Fix actions.
+These smart actions are available throughout the VS Code UI. For example, you can access Copilot smart actions from the editor context menu or through Quick Fix actions.
 
-Access the smart actions by selecting a block of code, right-clicking, and choosing **Copilot**. The smart actions are context-aware and can help you with common tasks, such as generating documentation, fixing code, or explaining code.
+In the editor, you can access smart actions by selecting a block of code, right-clicking, and then choosing **Copilot**.
 
 ![Editor context menu with the Copilot menu group expanded](images/copilot-chat/copilot-smart-action-menu.png)
 
-The most powerful smart action is `/fix`. Here is a relatively simple TypeScript calculator with an error noting that "Argument of type 'string' is not assignable to parameter of type 'number'". Select the *sparkle* icon, and then choose **Fix using Copilot**.
+The most powerful smart action is the **Fix** action. Here is a relatively simple TypeScript calculator with an error noting that "Argument of type 'string' is not assignable to parameter of type 'number'". Select the *sparkle* icon, and then choose **Fix**.
 
 ![Quick fix a type mismatch error by using the Copilot smart action](images/copilot-chat/smart-action-fix-with-copilot.png)
 
-Similar to `/fix`, the `/doc` smart action is popular with users. To use `/doc`, select a block of code, right-click, and choose **Copilot** > **Generate Docs**. Copilot will generate a documentation comment for your code.
+Similar to `/fix`, the `/doc` smart action is a popular action. To use `/doc`, select a block of code, right-click, and choose **Copilot** > **Generate Docs**. Copilot will generate a documentation comment for your code.
 
 ![Inline Chat /doc results adding JSDoc comment for a TypeScript function](images/copilot-chat/generate-docs-example.png)
 
+You can also invoke some of these smart actions by using their equivalent [slash command](#slash-commands) in chat. For example, you can use `/fix` to fix the problems in the selected code, or `/doc` to generate documentation for the selected code.
+
 ## Chat participants
 
 *Chat participants* are like experts who have a specialty that they can help you with. You can invoke a chat participant by typing '@' in the chat input field, followed by the participant name. There are several built-in chat participants:
@@ -328,21 +346,7 @@ Some examples of built-in slash commands are:
 
 To view the list of build-in participants and their commands, type `@` in the chat input field or select the <i class="codicon codicon-mention"></i> icon.
 
-## Improve the performance of Copilot Chat
-
-Copilot works best when it has sufficient context to know what you're doing and what you want help with. Just as you would provide a colleague with the context when asking for help with a specific programming task, you can do the same with Copilot.
-
-You can help Copilot provide better answers by upvoting or downvoting responses with the thumbs up and down icons in the upper right of its response. This provides Copilot feedback on how much it helped with your scenario so that it can help you even better in the future.
-
-### Use chat variables
-
-By using a chat variable in your chat prompt, you can be more specific about the context that you provide to Copilot. For example, the prompt _"which sorting algo is used #selection"_ focuses the chat request on the selected code snippet.
-
-### Use chat participants and commands
-
-Chat participants, such as `@workspace`, might have context associated within them. For example, `@vscode` is aware of VS Code settings and its APIs. When you include a chat participant in the chat prompt, you inherently add context to the prompt. Similarly, by using slash commands, you can further focus the intent of the chat request.
-
-### Conversation history
+## Conversation history
 
 Copilot keeps track of the history of your conversation in the Chat view. Copilot can use this information as context in subsequent prompts, for example when you have a [multi-turn conversation](#multi-turn-conversations).
 
@@ -356,14 +360,6 @@ You can delete a prompt and the corresponding response from the conversation his
 
 You can export all prompts and responses for a chat session in a JSON file with the **Chat: Export Chat...** command in the Command Palette.
 
-### Context in Inline Chat
-
-If you're using Inline Chat, and you have code selected in the editor, Copilot scopes your question to the selection.
-
-### Ignore files
-
-When you're using `@workspace` to ask questions related to your VS Code workspace, you can explicitly ignore specific files from the workspace by using a `.gitignore` file. `@workspace` respects `.gitignore` when deciding which files from the workspace to index.
-
 ## Use voice interactions
 
 With the voice control capabilities in VS Code, provided by the [VS Code Speech](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-speech) extension, you can initiate a chat conversation by using your voice:
@@ -390,30 +386,32 @@ Learn more about security, privacy, and transparency in the [GitHub Copilot Trus
 
 ## Frequently asked questions
 
-### How do I choose between Inline Chat, Chat view, and Quick Chat?
+### How do I choose between Copilot Edits, Inline Chat, Chat view, and Quick Chat?
 
 The following table provides a comparison of the capabilities of each interface.
 
-| Capability                          | Chat view | Inline Chat | Quick Chat |
-|-------------------------------------|:---------:|:-----------:|:----------:|
-| Ask general technology questions    | ✅ | ✅  | ✅ |
-| Receive code suggestions            | ✅ | ✅  | ✅ |
-| View code suggestions in the editor |    | ✅  |    |
-| Code suggestions for multiple files | ✅ |     | ✅ |
-| Generate a new project              | ✅ |     | ✅ |
-| Attach context                      | ✅ | ✅  | ✅ |
-| Use chat participants               | ✅ |     | ✅ |
-| Use commands                        | ✅ | ✅* | ✅ |
-| Chat history                        | ✅ |     |    |
+| Capability                   | Copilot Edits | Chat view | Inline Chat | Quick Chat |
+|------------------------------|:-------------:|:---------:|:-----------:|:----------:|
+| Receive code suggestions     | ✅ | ✅ | ✅ | ✅  |
+| Multi-file edits             | ✅ | ✅* |    | ✅* |
+| Preview code edits in editor | ✅ |     | ✅ |     |
+| Code review flow             | ✅ |     |    |      |
+| Roll back changes            | ✅ |     |    |      |
+| Attach context               | ✅ | ✅ | ✅ | ✅  |
+| Use participants & commands  |    | ✅  |    | ✅  |
+| Generate shell commands      |    | ✅  |    | ✅  |
+| General-purpose chat         |    | ✅  | ✅ | ✅  |
 
-\* _only a limited set of commands is available in Inline Chat_
+\* _code blocks are included in the chat conversation and need to be applied to the right file manually_
 
 ## Additional resources
 
 You can read more about [GitHub Copilot](https://github.com/features/copilot) and how to use it in VS Code in the [GitHub Copilot documentation](https://docs.github.com/copilot/getting-started-with-github-copilot?tool=vscode).
 
 Or check out the [VS Code Copilot Series](https://www.youtube.com/playlist?list=PLj6YeMhvp2S5_hvBl2SE-7YCHYlLQ0bPt) on YouTube, where you can find more introductory content and programming-specific videos for using Copilot with [Python](https://www.youtube.com/watch?v=DSHfHT5qnGc), [C#](https://www.youtube.com/watch?v=VsUQlSyQn1E), [Java](https://www.youtube.com/watch?v=zhCB95cE0HY), [PowerShell](https://www.youtube.com/watch?v=EwtRzAFiXEM), [C++](https://www.youtube.com/watch?v=ZfT2CXY5-Dc), and more.
 
-## Next step
+## Next steps
+
+* Get started with the introductory [Copilot Chat tutorial](/docs/copilot/getting-started-chat.md).
 
-Get started with the introductory [Copilot Chat tutorial](/docs/copilot/getting-started-chat.md).
+* Make edits across multiple files with [Copilot Edits](/docs/copilot/copilot-edits.md).