Merge branch 'main' into patch-3

Author: Sharra-writes

assets/images/help/copilot/enterprise-premium-request-budget.png

@@ -20,7 +20,7 @@ To keep your account secure, you must authenticate before you can access certain
 You can access your resources in {% data variables.product.github %} in a variety of ways: in the browser, via {% data variables.product.prodname_desktop %} or another desktop application, with the API, or via the command line. Each way of accessing {% data variables.product.github %} supports different modes of authentication.
 {%- ifversion not fpt %}
 * Your identity provider (IdP){% endif %}
-* Username and password with two-factor authentication, or a passkey
+* Username and password (or social login) with two-factor authentication, or a passkey ({% data variables.product.prodname_free_user %}, and {% data variables.product.prodname_ghe_cloud %} only)
 * {% data variables.product.pat_generic_caps %}
 * SSH key
 
@@ -46,9 +46,13 @@ If you need to use multiple accounts on {% data variables.location.product_locat
 
 * **Username and password only**
   * You'll create a password when you create your account on {% data variables.product.github %}. We recommend that you use a password manager to generate a random and unique password. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-strong-password).{% ifversion fpt or ghec %}
-  * If you have not enabled 2FA, {% data variables.product.github %} may ask for additional verification when you first sign in from a new or unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/verifying-new-devices-when-signing-in).{% endif %}
+  * If you have not enabled 2FA, {% data variables.product.github %} may ask for additional verification when you first sign in from a new or unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/verifying-new-devices-when-signing-in).{% endif %} {% ifversion fpt or ghec %}
+* **Social login**
+  * You'll authenticate with one of the supported social login providers (currently only Google is supported) when you create your account on {% data variables.product.github %}. We recommend that you also configure 2FA and add a passkey or a password as an additional account recovery mechanism.
+  * If you have an existing account created with a password, you can add your social login email to the account. This allows you to use your social login identity as a first-factor (password) replacement when you sign in to {% data variables.product.github %}.
+  * You can unlink your social login identities from your {% data variables.product.github %} email settings page. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account) {% endif %}
 * **Two-factor authentication (2FA)** (recommended)
-  * If you enable 2FA, after you successfully enter your username and password, we'll also prompt you to provide a code that's generated by a time-based one time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS).{% endif %}{% ifversion 2fa-check-up-period %}
+  * If you enable two-factor authentication (2FA), after you sign in with social login or your username and password, you'll be prompted to enter a code from a time-based one-time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS).{% endif %}{% ifversion 2fa-check-up-period %}
   * After you configure 2FA, your account enters a check up period for 28 days. You can leave the check up period by successfully performing 2FA within those 28 days. If you don't perform 2FA in that timespan, you'll then be asked to perform 2FA inside one of your existing {% data variables.product.prodname_dotcom %} sessions.
   * If you cannot perform 2FA to pass the 28th day checkup, you will be provided a shortcut that lets you reconfigure your 2FA settings. You must reconfigure your settings before you can access the rest of {% data variables.product.prodname_dotcom %}{% endif %}. For more information, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#providing-a-2fa-code-when-signing-in-to-the-website){% ifversion 2fa-check-up-period %} and [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication){% endif %}.
   * In addition to authentication with a TOTP application{% ifversion fpt or ghec %} or a text message{% endif %}, you can optionally add an alternative method of authentication with {% ifversion fpt or ghec %}{% data variables.product.prodname_mobile %} or{% endif %} a security key using WebAuthn. See {% ifversion fpt or ghec %}[Configuring two-factor authentication using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) or {% endif %}[Configuring two-factor authentication using a security key](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key).

content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md

@@ -52,6 +52,7 @@ To confirm access for sudo mode, you can authenticate with your password. Option
 {%- endif %}
 * [Confirming access using a 2FA code](#confirming-access-using-a-2fa-code)
 * [Confirming access using your password](#confirming-access-using-your-password)
+* [Confirming access using your social login email](#confirming-access-using-your-social-login-email)
 
 ### Confirming access using a passkey
 
@@ -87,3 +88,9 @@ When prompted to authenticate for sudo mode, type the authentication code from y
 ### Confirming access using your password
 
 When prompted to authenticate for sudo mode, type your password, then click **Confirm**.
+
+### Confirming access using your social login email
+
+Before you can access sudo mode, you must first configure social login. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/about-authentication-to-github).
+
+When prompted to authenticate for sudo mode, type the authentication code sent to your social login email account, then click **Verify**.

content/authentication/keeping-your-account-and-data-secure/sudo-mode.md

@@ -82,9 +82,9 @@ You can view the usage of your {% data variables.enterprise.enterprise_or_org %}
 1. To request a CSV usage report, select **Get usage report** in the upper-right corner of the page.
 
    * For a breakdown of all metered usage, click **Metered billing usage report**.
-   * For a per user breakdown of additional premium requests, click **{% data variables.product.prodname_copilot_short %} premium requests usage report**.
+   * For a per user breakdown of premium requests for the last 45 days, click **{% data variables.product.prodname_copilot_short %} premium requests usage report**.
 
-   You can choose a pre-selected option or use the "Custom range" option to specify a date range of up to 31 days.
+   >[!TIP] The premium request usage report includes all premium requests, both within and beyond the allowance. By contrast, the metered billing usage report only reflects costs for requests beyond the allowance.
 
 ## Viewing license usage
 

content/billing/managing-your-billing/gathering-insights-on-your-spending.md

@@ -132,7 +132,6 @@ As the owner of an enterprise or organization account, or as a billing manager,
 
 You can edit or delete a budget at any time, but you cannot change the scope of a budget after creating it.
 
-1. In the "Budgets and alerts" view, click **New budget**.
-1. Click **Budgets and alerts**.
-1. To edit a budget, in the list of budgets, click {% octicon "kebab-horizontal" aria-label="View actions" %} next to the budget you want to edit, and click **{% octicon "pencil" aria-hidden="true" aria-label="pencil" %} Edit** or **{% octicon "trash" aria-hidden="true" aria-label="trash" %} Delete**.
+1. Navigate to the "Budgets and alerts" view. See [Viewing budgets](#viewing-budgets).
+1. In the list of budgets, click {% octicon "kebab-horizontal" aria-label="View actions" %} next to the budget you want to edit, and click **{% octicon "pencil" aria-hidden="true" aria-label="pencil" %} Edit** or **{% octicon "trash" aria-hidden="true" aria-label="trash" %} Delete**.
 1. Follow the prompts.

content/billing/managing-your-billing/using-budgets-control-spending.md

@@ -0,0 +1,87 @@
+---
+title: Copilot code referencing
+shortTitle: Code referencing
+allowTitleToDifferFromFilename: true
+intro: '{% data variables.product.prodname_copilot %} checks suggestions for matches with publicly available code. Any matches are discarded or suggested with a code reference.'
+defaultTool: vscode
+topics:
+  - Copilot
+versions:
+  feature: copilot
+type: overview
+---
+
+{% jetbrains %}
+
+## About {% data variables.product.prodname_copilot_short %} code referencing in JetBrains IDEs
+
+{% data reusables.copilot.about-code-referencing %}
+
+### Code referencing for {% data variables.product.prodname_copilot_short %} code completion
+
+{% data reusables.copilot.code-referencing-note %}
+
+### Code referencing for {% data variables.copilot.copilot_chat_short %}
+
+{% data reusables.copilot.code-referencing-in-chat %}
+
+{% endjetbrains %}
+
+{% vscode %}
+
+## About {% data variables.product.prodname_copilot_short %} code referencing in {% data variables.product.prodname_vscode %}
+
+{% data reusables.copilot.about-code-referencing %}
+
+### Code referencing for {% data variables.product.prodname_copilot_short %} code completion
+
+{% data reusables.copilot.code-referencing-note %}
+
+### Code referencing for {% data variables.copilot.copilot_chat_short %}
+
+{% data reusables.copilot.code-referencing-in-chat %}
+
+{% endvscode %}
+
+{% webui %}
+
+## About {% data variables.product.prodname_copilot_short %} code referencing on {% data variables.product.prodname_dotcom_the_website %}
+
+If you've allowed suggestions that match public code, then whenever a response from {% data variables.copilot.copilot_chat_short %} includes matching code, details of the matches will be included in the response.
+
+> [!NOTE]
+> Typically, matches to public code occur infrequently, so you should not expect to see code references in many {% data variables.copilot.copilot_chat_short %} responses.
+
+{% endwebui %}
+
+{% visualstudio %}
+
+## About {% data variables.product.prodname_copilot_short %} code referencing in {% data variables.product.prodname_vs %}
+
+{% data reusables.copilot.about-code-referencing %}
+
+### Code referencing for {% data variables.product.prodname_copilot_short %} code completion
+
+{% data reusables.copilot.code-referencing-note %}
+
+### Code referencing for {% data variables.copilot.copilot_chat_short %}
+
+When {% data variables.copilot.copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated below the suggested code, with a link to display details of the matched code in the output log.
+
+{% endvisualstudio %}
+
+## How code referencing finds matching code
+
+{% data variables.product.prodname_copilot_short %} code referencing searches for matches by taking the code suggestion, plus some of the code that will surround the suggestion if it is accepted, and comparing it against an index of all public repositories on {% data variables.product.prodname_dotcom_the_website %}.
+
+Code in private {% data variables.product.prodname_dotcom %} repositories, or code outside of {% data variables.product.prodname_dotcom %}, is not included in the search process.
+
+The search index is refreshed every few months. As a result, newly committed code, and code from public repositories deleted before the index was created, may not be included in the search. For the same reason, the search may return matches to code that has been deleted or moved since the index was created.
+
+## Limitations
+
+References to matching code are currently available in JetBrains IDEs, {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, and on the {% data variables.product.github %} website.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/how-tos/completions/finding-public-code-that-matches-github-copilot-suggestions)

content/copilot/concepts/completions/code-referencing.md

@@ -0,0 +1,88 @@
+---
+title: Copilot code suggestions in your IDE
+shortTitle: IDE code suggestions
+allowTitleToDifferFromFilename: true
+intro: Learn about {% data variables.product.prodname_copilot_short %} code suggestions in different IDEs.'
+versions:
+  feature: copilot
+type: overview
+defaultTool: vscode
+topics:
+  - Copilot
+---
+
+{% vscode %}
+
+## About code suggestions in {% data variables.product.prodname_vscode %}
+
+{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vscode %} provides two kinds of code suggestions:
+
+* **Code completion**
+   * {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type. You can also describe something you want to do using natural language within a comment, and {% data variables.product.prodname_copilot_short %} will suggest the code to accomplish your goal.
+* **{% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %})**
+   * Based on the edits you are making, {% data variables.product.prodname_copilot_short %} will predict the location of the next edit you are likely to make and suggest a completion for it. Suggestions may span a single symbol, an entire line, or multiple lines, depending on the scope of the potential change. To enable {% data variables.copilot.next_edit_suggestions %}, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment#enabling-next-edit-suggestions).
+
+{% data reusables.copilot.supported-languages %}
+
+{% endvscode %}
+
+{% jetbrains %}
+
+## About code suggestions in JetBrains IDEs
+
+{% data variables.product.prodname_copilot_short %} offers code completion suggestions as you type.
+
+{% data reusables.copilot.supported-languages %}
+
+{% endjetbrains %}
+
+{% visualstudio %}
+
+## About code suggestions in {% data variables.product.prodname_vs %}
+
+{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %} provides two kinds of code suggestions:
+
+* **Code completion**
+   * {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type.
+* **{% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %})**
+   * Based on the edits you are making, {% data variables.product.prodname_copilot_short %} will predict the location of the next edit you are likely to make and suggest a completion for it. Suggestions may span a single symbol, an entire line, or multiple lines, depending on the scope of the potential change. To enable {% data variables.copilot.next_edit_suggestions %}, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/configuring-github-copilot-in-your-environment#enabling-next-edit-suggestions).
+
+{% data reusables.copilot.supported-languages %}
+
+{% endvisualstudio %}
+
+{% vimneovim %}
+
+## About code suggestions in Vim/Neovim
+
+{% data variables.product.prodname_copilot %} provides code completion suggestions inline as you type in Vim/Neovim.
+
+{% endvimneovim %}
+
+{% azure_data_studio %}
+
+## About code suggestions in Azure Data Studio
+
+{% data variables.product.prodname_copilot %} provides you with inline suggestions as you create SQL databases in Azure Data Studio.
+
+{% endazure_data_studio %}
+
+{% xcode %}
+
+## About code suggestions in Xcode
+
+{% data variables.product.prodname_copilot %} offers code completion suggestions as you type.
+
+{% endxcode %}
+
+{% eclipse %}
+
+## About code suggestions in Eclipse
+
+{% data variables.product.prodname_copilot %} offers code completion suggestions as you type.
+
+{% endeclipse %}
+
+## Next steps
+
+* [AUTOTITLE](/copilot/how-tos/completions/getting-code-suggestions-in-your-ide-with-github-copilot)

content/copilot/concepts/completions/code-suggestions.md

@@ -0,0 +1,13 @@
+---
+title: 'Completions for GitHub Copilot'
+shortTitle: Completions
+intro: 'Learn about code completions from {% data variables.product.prodname_copilot %}.'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+children:
+  - /code-suggestions
+  - /text-completion
+  - /code-referencing
+---

content/copilot/concepts/completions/index.md

@@ -0,0 +1,23 @@
+---
+title: Copilot text completion
+shortTitle: Text completion
+allowTitleToDifferFromFilename: true
+intro: 'Learn about {% data variables.copilot.copilot_autocomplete_pr %}.'
+versions:
+  feature: copilot-enterprise
+permissions: 'Members of an enterprise with a subscription to [{% data variables.copilot.copilot_enterprise %}](/copilot/github-copilot-enterprise/overview/about-github-copilot-enterprise)'
+topics:
+  - Copilot
+---
+
+{% data reusables.copilot.text-completion-preview %}
+
+## About {% data variables.copilot.copilot_autocomplete_pr %}
+
+With {% data variables.copilot.copilot_autocomplete_pr %}, you can use AI-generated autocompletions to help you write pull request descriptions quickly and accurately. Accurate descriptions help reviewers understand the changes you're proposing, and help you communicate the purpose of your pull request more effectively.
+
+When you are creating a new pull request, {% data variables.copilot.copilot_autocomplete_pr %} will scan through the pull request and provide suggestions as you write, based on the context of the pull request.
+
+## Next steps
+
+* [AUTOTITLE](/copilot/how-tos/completions/using-copilot-text-completion)

content/copilot/concepts/completions/text-completion.md

@@ -67,9 +67,10 @@ If you're on a **paid plan** and use all of your premium requests, you can still
 If you need more premium requests beyond your monthly allowance, you can:
 
 * Set a spending limit for additional premium requests. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
-* Upgrade to a higher plan.
+* Upgrade your individual subscription to a higher plan.
+* If you're an enterprise owner, edit the default $0 budget or upgrade members to {% data variables.copilot.copilot_enterprise_short %}. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
 
-These actions can be taken by organization owners, billing managers, and personal account users.
+These actions can be taken by enterprise owners, organization owners, billing managers, and personal account users.
 
 > [!IMPORTANT] By default, all budgets are set to zero and premium requests over the allowance are rejected unless a budget has been created. Additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request.