Merge pull request #7958 from microsoft/copilot-setup

Update Copilot docs

Author: ntrogh

docs/copilot/ai-powered-suggestions.md

@@ -12,19 +12,6 @@ MetaSocialImage: images/shared/github-copilot-social.png
 
 GitHub Copilot acts as an AI-powered pair programmer, automatically offering suggestions to complete your code, comments, tests, and more. It provides these suggestions directly in the editor while you write your code, and it can work with a broad range of programming languages and frameworks.
 
-## Getting started
-
-1. Install the GitHub Copilot extensions.
-
-    > <a class="install-extension-btn" href="vscode:extension/GitHub.copilot?referrer=docs-copilot-ai-powered-suggestions">Install the GitHub Copilot extensions</a>
-
-1. Sign in with your GitHub account to use Copilot.
-
-    > [!TIP]
-    > If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of completions and chat interactions.
-
-1. Discover the key features of Copilot in VS Code with our [Copilot Quickstart](/docs/copilot/getting-started.md).
-
 ## Inline suggestions
 
 Copilot offers code suggestions as you type: sometimes the completion of the current line, sometimes a whole new block of code. You can accept all, or part of a suggestion, or you can keep typing and ignore the suggestions.

docs/copilot/copilot-chat.md

@@ -17,12 +17,6 @@ Instead of using chat to get suggestions, Copilot can also directly make edits a
 > [!TIP]
 > If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](https://github.com/github-copilot/signup) and get a monthly limit of completions and chat interactions.
 
-## Prerequisites
-
-* Access to GitHub Copilot in VS Code. See [Setup Copilot in VS Code](/docs/copilot/setup.md).
-
-* Latest version of Visual Studio Code. See the [VS Code download page](https://code.visualstudio.com/Download).
-
 ## Access Copilot Chat in VS Code
 
 You can submit prompts to Copilot in VS Code in several ways, depending on your workflow.

docs/copilot/faq.md

@@ -18,13 +18,10 @@ This article answers frequently asked questions about using GitHub Copilot in Vi
 
 There are different ways to get access to GitHub Copilot:
 
-* As an individual, you can sign up to use [Copilot for free](https://github.com/github-copilot/signup), without the need for a credit card. You are entitled to a limited number of completions and chat interactions per month with the free plan, which reset each month. Learn more about the [Copilot Free plan details and conditions](https://docs.github.com/en/copilot/about-github-copilot/subscription-plans-for-github-copilot).
-
-* As an individual, sign up for a [paid subscription](https://github.com/github-copilot/signup/copilot_individual) to get unlimited completions and chat interactions. You can try GitHub Copilot for free with a one-time 30-day trial.
-
-* If you are a member of an organization or enterprise that has a subscription to GitHub Copilot, you can request access to Copilot by going to <https://github.com/settings/copilot> and requesting access under "Get Copilot from an organization."
-
-Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot).
+| Type of User                   | Description |
+|--------------------------------|-------------|
+| Individual                     | <ul><li>Set up [GitHub Copilot Free](https://github.com/github-copilot/signup) to get a limited experience of Copilot without a subscription. See [About GitHub Copilot Free](https://docs.github.com/en/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free).</li><li>Sign up for a paid GitHub Copilot subscription to get unlimited completions and chat interactions. You can [try GitHub Copilot for free](https://github.com/github-copilot/signup?ref_cta=Copilot+trial&ref_loc=about+github+copilot&ref_page=docs) with a one-time 30-day trial.</li><li>See [Setting up GitHub Copilot for yourself](https://docs.github.com/en/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself) for all options. </li></ul> |
+| Organization/Enterprise member | <ul><li>If you are a member of an organization or enterprise that has a subscription to GitHub Copilot, you can request access to Copilot by going to <https://github.com/settings/copilot> and requesting access under "Get Copilot from an organization."</li><li>See [Setting up GitHub Copilot for your organization](https://docs.github.com/en/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization) to enable Copilot for your organization.</li></ul> |
 
 ### I reached my completions or chat interactions limit
 

docs/copilot/getting-started-chat.md

@@ -19,11 +19,12 @@ If you're new to using GitHub Copilot in VS Code, see the [GitHub Copilot Overvi
 
 ## Prerequisites
 
-* To use GitHub Copilot in VS Code, you must have the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension. When you install this extension, the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension is also installed.
+To use GitHub Copilot in VS Code, you need to have the following:
 
-* To use GitHub Copilot, you must have an active subscription for GitHub Copilot in your personal account, or you need to be assigned a seat by your organization.
+* Access to GitHub Copilot
+* GitHub Copilot extensions installed in VS Code
 
-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.
+Follow the steps in the [GitHub Copilot set up guide](/docs/copilot/setup.md) to get access to GitHub Copilot and install the Copilot extensions in VS Code.
 
 ## Get your first Copilot chat conversation
 

docs/copilot/getting-started.md

@@ -21,11 +21,12 @@ While we're using TypeScript for this tutorial, please note that Copilot is also
 
 ## Prerequisites
 
-* To use GitHub Copilot in VS Code, you must have the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension. When you install this extension, the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension is also installed.
+To use GitHub Copilot in VS Code, you need to have the following:
 
-* To use GitHub Copilot, you must have an active subscription for GitHub Copilot in your personal account, or you need to be assigned a seat by your organization.
+* Access to GitHub Copilot
+* GitHub Copilot extensions installed in VS Code
 
-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.
+Follow the steps in the [GitHub Copilot set up guide](/docs/copilot/setup.md) to get access to GitHub Copilot and install the Copilot extensions in VS Code.
 
 ## Get your first code suggestion
 

docs/copilot/overview.md

@@ -58,11 +58,9 @@ GitHub Copilot can provide assistance in a variety of scenarios.
 
 ## Getting started
 
-1. Install the GitHub Copilot extensions.
+1. Select **Use AI Features with Copilot for Free...** from the Copilot menu in the VS Code title bar
 
-    > <a class="install-extension-btn" href="vscode:extension/GitHub.copilot?referrer=docs-copilot-overview">Install the GitHub Copilot extensions</a>
-
-1. Sign in with your GitHub account to use Copilot.
+1. Sign in with your GitHub account to use Copilot
 
     > [!TIP]
     > You can get started for free with the [Copilot Free plan](https://github.com/github-copilot/signup) if you don't yet have a Copilot subscription. Follow the steps in the [setup guide](/docs/copilot/setup.md) to set up a Copilot subscription.

docs/copilot/setup-simplified.md

@@ -12,16 +12,13 @@ MetaSocialImage: images/shared/github-copilot-social.png
 
 Welcome to AI-powered development with Visual Studio Code! Follow the steps in this guide to get started in minutes.
 
-> [!TIP]
-> If you don't yet have a Copilot subscription, you can use Copilot for free by signing up for the [Copilot Free plan](#related-resources) and get a monthly limit of completions and chat interactions.
-
 ## Enable Copilot Free in VS Code
 
-1. [Download Visual Studio Code](https://code.visualstudio.com/Download) for your platform
+1. [Download and install Visual Studio Code](https://code.visualstudio.com/Download) for your platform
 
 1. Start VS Code
 
-1. Press `kb(workbench.action.chat.open)` or select **Use AI Features with Copilot for Free...** from the Copilot menu in the title bar
+1. Select **Use AI Features with Copilot for Free...** from the Copilot menu in the title bar or from the Command Palette (`kb(workbench.action.showCommands)`)
 
     ![The Copilot menu in the VS Code title bar, showing the option to use AI features with Copilot for free.](images/setup/copilot-menu-use-ai-features.png)
 

docs/copilot/setup.md

@@ -19,15 +19,18 @@ This guide walks you through setting up GitHub Copilot in Visual Studio Code. To
 
 There are different ways to get access to GitHub Copilot:
 
-* As an individual, you can sign up to use [Copilot for free](https://github.com/github-copilot/signup), without the need for a credit card. You are entitled to a limited number of completions and chat interactions per month with the free plan, which reset each month. Learn more about the [Copilot Free plan details and conditions](https://docs.github.com/en/copilot/about-github-copilot/subscription-plans-for-github-copilot).
+| Type of User                   | Description |
+|--------------------------------|-------------|
+| Individual                     | <ul><li>Set up [GitHub Copilot Free](https://github.com/github-copilot/signup) to get a limited experience of Copilot without a subscription. See [About GitHub Copilot Free](https://docs.github.com/en/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/about-github-copilot-free).</li><li>Sign up for a paid GitHub Copilot subscription to get unlimited completions and chat interactions. You can [try GitHub Copilot for free](https://github.com/github-copilot/signup?ref_cta=Copilot+trial&ref_loc=about+github+copilot&ref_page=docs) with a one-time 30-day trial.</li><li>See [Setting up GitHub Copilot for yourself](https://docs.github.com/en/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself) for all options. </li></ul> |
+| Organization/Enterprise member | <ul><li>If you are a member of an organization or enterprise that has a subscription to GitHub Copilot, you can request access to Copilot by going to <https://github.com/settings/copilot> and requesting access under "Get Copilot from an organization."</li><li>See [Setting up GitHub Copilot for your organization](https://docs.github.com/en/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization) to enable Copilot for your organization.</li></ul> |
 
-* As an individual, sign up for a [paid subscription](https://github.com/github-copilot/signup/copilot_individual) to get unlimited completions and chat interactions. You can try GitHub Copilot for free with a one-time 30-day trial.
-
-* If you are a member of an organization or enterprise that has a subscription to GitHub Copilot, you can request access to Copilot by going to <https://github.com/settings/copilot> and requesting access under "Get Copilot from an organization."
+## Set up Copilot in VS Code
 
-Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot).
+VS Code provides a streamlined experience to set up GitHub Copilot that takes you through the following steps:
 
-## Set up Copilot in VS Code
+* Installs the GitHub Copilot extensions in VS Code
+* Signs in to your GitHub account
+* If you don't have a Copilot subscription yet, signs you up for the [Copilot Free plan](https://github.com/github-copilot/signup)
 
 1. Open the Copilot menu in the VS Code title bar and select **Use AI Features with Copilot for Free...** to open the Chat view
 
@@ -36,10 +39,12 @@ Learn more about [billing for GitHub Copilot](https://docs.github.com/billing/ma
     > [!TIP]
     > You can also open the Chat view directly by using the keyboard shortcut `kb(workbench.action.chat.open)` or with the **Chat: Focus on Chat View** command.
 
-1. Select **Sign in to Use Copilot** to sign in to your GitHub account and get started. This also installs the GitHub Copilot extensions in VS Code.
+1. Select **Sign in to Use Copilot for free** to sign in to your GitHub account. This step also installs the Copilot extensions.
 
     ![Chat view shows the Copilot message and a button that enables you to sign in to use Copilot.](images/setup/copilot-chat-view-new-user.png)
 
+    If you already have a Copilot subscription, you can now start using Copilot in VS Code.
+
 1. If you don't yet have a Copilot subscription, follow the steps in the browser to sign up for the Copilot Free plan
 
     > [!IMPORTANT]
@@ -57,7 +62,14 @@ After you've signed in to your GitHub account and have access to Copilot, start
 
 1. Continue with the [Copilot Quickstart](/docs/copilot/getting-started.md) to discover the key features of Copilot in VS Code.
 
-## Install Copilot extensions in VS Code
+## Manually set up GitHub Copilot in VS Code
+
+To manually set up GitHub Copilot in VS Code, you need to perform the following steps:
+
+* Install the GitHub Copilot extensions in VS Code
+* Sign in to Copilot
+
+### Install the GitHub Copilot extensions
 
 To manually install the GitHub Copilot extensions:
 
@@ -68,7 +80,7 @@ You can also open the Extensions view and search for *GitHub Copilot* to install
 > [!NOTE]
 > When you install the GitHub Copilot extension, the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension is also installed.
 
-## Sign in to Copilot
+### Sign in to Copilot
 
 Sign in to your GitHub account by entering **GitHub Copilot: Sign in** in the Command Palette (`kb(workbench.action.showCommands)`)