Merge pull request #7794 from ntrogh/copilot-docs-1124

Update Copilot docs

Author: ntrogh

docs/copilot/copilot-chat.md

@@ -237,16 +237,18 @@ Similar to `/fix`, the `/doc` smart action is popular with users. To use `/doc`,
 
 ## Chat participants
 
-To further help Copilot give you more relevant answers, you can indicate the scope and intent of your question through chat *participants*.
-
-Chat participants are like experts who have a specialty that they can help you with, and you can talk to them in the chat by mentioning them with the `@` symbol. Currently, these are the following built-in 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:
 
 * `@workspace` has context about the code in your workspace and can help you navigate it, finding relevant files or classes.
 * `@vscode` knows about commands and features in the VS Code editor itself, and can help you use them.
 * `@terminal` has context about the integrated terminal shell and its contents.
 * `@github` has knowledge about your GitHub repositories, issues, pull requests, and topics, and can also perform web searches using the Bing API.
 
-Extensions can also contribute chat participants to provide specialized help for their domain.
+Extensions can also contribute chat participants to provide specialized help for their domain. To find the list of available chat participants, type `@` in the chat input field.
+
+These are some examples of extensions in the Visual Studio Marketplace that contribute a chat participant to the Chat view in VS Code. Go to the [Marketplace](https://marketplace.visualstudio.com/search?term=tag%3Achat-participant&target=VSCode&category=All%20categories&sortBy=Relevance) or use the integrated [Extensions view](/docs/editor/extension-marketplace.md) and search for more extensions by using the `chat-participant` tag.
+
+<div class="marketplace-extensions-chat"></div>
 
 ### @workspace
 
@@ -311,28 +313,20 @@ Chat participants contributed via a GitHub App do not run on your local machine
 
 ## Slash commands
 
-One of the tasks when answering questions is to determine the intent, understanding what you want to do. You can use natural language to describe your intent, but it can be ambiguous. To help with this, you can use *slash commands*. Chat participants can contribute slash commands, which are shortcuts to specific, commonly used functionality provided by that chat participant.
+Chat participants can provide shortcuts to specific functionality by using *slash commands*. These commands provide a concise and structured way to interact with chat participants and to give them instructions. You can reference slash commands in your chat prompt by typing the participant, followed by `/` and the command name.
 
-For example, we can infer that "Create a new workspace with Node.js Express Pug TypeScript" means that you want a new project. Instead, you can also use "@workspace /new Node.js Express Pug TypeScript" is explicit, concise, and saves you time typing. In this case, the `/new` slash command is a shortcut to create a new workspace.
+For example, the `@workspace` participant has a slash command `/new` to scaffold a new workspace or a new file. Typing `@workspace /new Node.js Express Pug TypeScript` in the chat input field creates a new workspace with a Node.js Express Pug TypeScript project.
 
-Once the intent is clear, `@workspace` has a better chance of addressing your needs, despite the inherent ambiguity of natural language. The @workspace chat participant can propose a directory structure and users can select the proposed files to preview them. There is a **Create Workspace** button that generates these files in a new folder.
-
-Examples of built-in commands - type `@` or select the <i class="codicon codicon-mention"></i> icon.
+Some examples of built-in slash commands are:
 
 * `/clear`: start a new chat session
 * `/help`: get help about using GitHub Copilot
-* `/doc`: generate code documentation (Inline Chat)
 * `@workspace /explain` (or `/explain`): explain how the selected code works
 * `@workspace /fix` (or `/fix`): propose a fix for the problems in the selected code
-* `@workspace /fixTestFailure` (preview): propose a fix for failing tests
-* `@workspace /setupTests`: configure a testing framework for your workspace
-* `@workspace /tests` (or `/tests`): generate unit tests for the selected code
 * `@workspace /new` (or `/new`): scaffold code for a new workspace or new file
-* `@workspace /newNotebook` (or `/newNotebook`): create a new Jupyter Notebook
 * `@vscode /runCommand`: search or run a VS Code command
-* `@vscode /search` (or `/search`): generate query parameters for the Search view
-* `@vscode /startDebugging` (experimental): generate `launch.json` file to set up debugging configuration and start debugging
-* `@terminal /explain`: explain terminal functionality or shell commands
+
+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
 

docs/copilot/getting-started-chat.md

@@ -26,7 +26,7 @@ Follow these steps to [set up GitHub Copilot in VS Code](/docs/copilot/setup.md)
 
 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.
+In this tutorial, you'll be creating a simple Node.js web application.
 
 1. Open the Chat view from the Command Center chat menu or press `kb(workbench.action.chat.open)`.
 
@@ -35,40 +35,6 @@ In this tutorial, you'll be creating a simple Node.js web application. So, let's
     > [!TIP]
     > You can access different Copilot features from the Command Center menu at any time.
 
-1. In the chat input field, enter *give a list of nodejs web server frameworks*, and then press `kb(workbench.action.chat.submit)` to send the request to Copilot.
-
-    Copilot returns a list of web frameworks and with some additional information. So, you can search for coding information while you stay in VS Code.
-
-    Note that your results might be different from what is shown in the screenshots. AI models are non-deterministic, which means that they can return different responses when asked the same question. This might be due to additional learning and adaption over time, language variation, changes in context, such as your chat history, and more.
-
-    ![Screenshot of VS Code, showing the Copilot Chat view, showing the chat response and a suggested follow-up question.](./images/getting-started-chat/copilot-chat-view-node-frameworks.png)
-
-    Notice that Copilot also suggests relevant follow-up questions, which you can select to directly submit directly to Copilot.
-
-    > [!TIP]
-    > To get help about GitHub Copilot and how to interact with Copilot Chat, you can type `/help` in the chat input field.
-
-1. Let's get more information about Express.js. Enter *how to get started with express* in the chat input field.
-
-    The response contains step-by-step instructions for setting up an Express.js app and might also include code blocks with shell commands or implementation code. Code blocks in the chat response support IntelliSense, which enables you get information about methods and symbols by hovering over them, or to go to their definition.
-
-    ![Screenshot of VS Code Copilot Chat view, showing the chat response with code blocks in the response.](./images/getting-started-chat/copilot-chat-view-express-app.png)
-
-    When Copilot returns a code block, you can select the **Apply in Editor** button to let Copilot insert the code in the active editor for you at the appropriate location. Alternatively, you can also insert the code at the cursor position, or copy the code to the clipboard.
-
-    ![Screenshot of VS Code Copilot Chat view, showing the context menu for code blocks.](./images/getting-started-chat/copilot-chat-view-code-block-actions.png)
-
-    When the chat response contains links to a file, you can drag and drop that file from the Chat view to the editor to open it.
-
-    > [!TIP]
-    > Experiment with different questions and see how Copilot responds. For example, you can ask for only code samples ("give me 3 code samples to create an express app"), or ask how to add basic authentication to an Express app ("how to create an express app with basic auth"), and much more!
-
-## Generate a new workspace
-
-Even to create a simple Express.js application involves creating multiple files: a JavaScript file to set up the server, a `package.json`, HTML (template) files, and more. Rather than asking Copilot to generate each individual file, you can instruct it to create an entire workspace for you.
-
-Let's ask Copilot to generate a workspace for an Express.js and Pug application.
-
 1. Enter *@workspace /new express with typescript and pug* in the chat input field, and press `kb(workbench.action.chat.submit)` to send the request.
 
     Notice how this chat prompt is structured to provide clear and concise instructions to Copilot. Let's break it down:
@@ -93,7 +59,7 @@ Congratulations! You've just created a workspace with Copilot Chat by using natu
 
 ## Use chat participants
 
-Previously, you already used the `@workspace` chat participant to generate a new workspace, but you can also use it to ask questions about the actual code in the workspace.
+Previously, you used the `@workspace` chat participant to generate a new workspace, but you can also use it to ask questions about the actual code in the workspace.
 
 Let's iterate on our generated Express app and add a new page to it.