From c31b38c7300ecc0d7b2d2ba6f466d5aba6f7cb79 Mon Sep 17 00:00:00 2001 From: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Date: Tue, 21 May 2024 10:52:21 -0400 Subject: [PATCH] Add content for the limited public beta of Copilot Extensibility (#50525) Co-authored-by: hubwriter --- ...s-for-github-copilot-in-your-enterprise.md | 4 +- .../about-github-marketplace-for-apps.md | 8 +++ content/copilot/about-github-copilot.md | 4 +- ...ut-github-copilot-chat-in-github-mobile.md | 3 +- ...g-github-copilot-chat-for-github-mobile.md | 6 +- .../copilot-chat-in-github-mobile/index.md | 10 +++ ...ng-github-copilot-chat-in-github-mobile.md | 12 ++-- .../about-github-copilot-chat-in-githubcom.md | 5 +- .../copilot-chat-in-github/index.md | 4 +- .../managing-copilot-knowledge-bases.md | 5 +- .../using-github-copilot-chat-in-githubcom.md | 8 ++- .../about-github-copilot-chat-in-your-ide.md} | 14 ++--- .../copilot-chat-in-ides/index.md | 9 +++ .../using-github-copilot-chat-in-your-ide.md | 3 +- .../about-github-copilot-extensions.md | 39 ++++++++++++ .../github-copilot-extensions/index.md | 15 +++++ ...opilot-extensions-for-your-organization.md | 34 ++++++++++ ...ot-extensions-for-your-personal-account.md | 31 ++++++++++ .../managing-github-copilot-extensions.md | 62 +++++++++++++++++++ .../using-github-copilot-extensions.md | 50 +++++++++++++++ content/copilot/github-copilot-chat/index.md | 11 ++-- .../github-copilot-enterprise/index.md | 1 - ...ling-github-copilot-enterprise-features.md | 4 +- ...atures-for-copilot-in-your-organization.md | 4 +- content/copilot/quickstart.md | 2 +- ...issues-with-github-copilot-chat-in-ides.md | 4 +- .../getting-started-with-github-copilot.md | 4 +- .../get-started/using-github/github-mobile.md | 2 +- ...wing-proposed-changes-in-a-pull-request.md | 2 +- data/features/copilot-extensions.yml | 6 ++ .../reusables/apps/access-org-app-settings.md | 1 + .../copilot/chat-procedural-intro.md | 4 +- .../copilot/copilot-enterprise-enable.md | 4 +- .../copilot/copilot-enterprise-features.md | 2 +- .../copilot/copilot-extensions/beta-note.md | 1 + .../compatible-chat-interfaces.md | 3 + .../copilot-extensions-intro.md | 1 + .../copilot-extensions-on-marketplace.md | 1 + .../copilot/copilot-individual-features.md | 4 +- .../enterprise-accounts/copilot-tab.md | 2 +- .../gated-features/copilot-extensions.md | 5 ++ .../marketplace/visit-marketplace.md | 6 -- data/variables/copilot.yml | 5 ++ data/variables/product.yml | 4 ++ 44 files changed, 349 insertions(+), 60 deletions(-) rename content/copilot/github-copilot-chat/{ => copilot-chat-in-github-mobile}/about-github-copilot-chat-in-github-mobile.md (95%) rename content/copilot/github-copilot-chat/{ => copilot-chat-in-github-mobile}/enabling-github-copilot-chat-for-github-mobile.md (90%) create mode 100644 content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/index.md rename content/copilot/github-copilot-chat/{ => copilot-chat-in-github-mobile}/using-github-copilot-chat-in-github-mobile.md (95%) rename content/copilot/{github-copilot-enterprise => github-copilot-chat}/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md (98%) rename content/copilot/{github-copilot-enterprise => github-copilot-chat}/copilot-chat-in-github/index.md (52%) rename content/copilot/{github-copilot-enterprise => github-copilot-chat}/copilot-chat-in-github/managing-copilot-knowledge-bases.md (94%) rename content/copilot/{github-copilot-enterprise => github-copilot-chat}/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md (98%) rename content/copilot/github-copilot-chat/{about-github-copilot-chat.md => copilot-chat-in-ides/about-github-copilot-chat-in-your-ide.md} (95%) create mode 100644 content/copilot/github-copilot-chat/copilot-chat-in-ides/index.md rename content/copilot/github-copilot-chat/{ => copilot-chat-in-ides}/using-github-copilot-chat-in-your-ide.md (99%) create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions.md create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/index.md create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization.md create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account.md create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions.md create mode 100644 content/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions.md create mode 100644 data/features/copilot-extensions.yml create mode 100644 data/reusables/apps/access-org-app-settings.md create mode 100644 data/reusables/copilot/copilot-extensions/beta-note.md create mode 100644 data/reusables/copilot/copilot-extensions/compatible-chat-interfaces.md create mode 100644 data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md create mode 100644 data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md create mode 100644 data/reusables/gated-features/copilot-extensions.md diff --git a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md index d0e1e82fa0de..05db71724d8f 100644 --- a/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md +++ b/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise.md @@ -65,7 +65,7 @@ You can enable or disable the use of these features for organizations in your en ## Enforcing a policy to manage the use of {% data variables.product.prodname_copilot_chat %} in IDEs -{% data variables.product.prodname_copilot_chat %} is a feature that allows users to chat with {% data variables.product.prodname_copilot %} to get code suggestions and answers to coding-related questions. You can enable or disable the use of {% data variables.product.prodname_copilot_chat %} in IDEs for organizations in your enterprise. Alternatively, you can allow organization owners to select their own policy to determine access to {% data variables.product.prodname_copilot_chat %} for their organization. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat)." +{% data variables.product.prodname_copilot_chat %} is a feature that allows users to chat with {% data variables.product.prodname_copilot %} to get code suggestions and answers to coding-related questions. You can enable or disable the use of {% data variables.product.prodname_copilot_chat %} in IDEs for organizations in your enterprise. Alternatively, you can allow organization owners to select their own policy to determine access to {% data variables.product.prodname_copilot_chat %} for their organization. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide)." To manage the use of {% data variables.product.prodname_copilot_chat_dotcom_short %}, see "[Enforcing a policy to manage the use of {% data variables.product.prodname_copilot %} features on {% data variables.product.prodname_dotcom_the_website %}](#enforcing-a-policy-to-manage-the-use-of-github-copilot-features-on-githubcom)." @@ -85,7 +85,7 @@ To manage the use of {% data variables.product.prodname_copilot_chat_dotcom_shor ## Enforcing a policy to manage the use of {% data variables.product.prodname_copilot_mobile %} -{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. You can enable or disable the use of {% data variables.product.prodname_copilot_mobile_short %} for organizations in your enterprise. Alternatively, you can allow organization owners to select their own policy for {% data variables.product.prodname_copilot_mobile_short %} for their organization. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile)." +{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. You can enable or disable the use of {% data variables.product.prodname_copilot_mobile_short %} for organizations in your enterprise. Alternatively, you can allow organization owners to select their own policy for {% data variables.product.prodname_copilot_mobile_short %} for their organization. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile)." {% data reusables.copilot.copilot-chat-mobile-enable %} diff --git a/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md b/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md index 89b18eb71b50..e3ca27fb8562 100644 --- a/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md +++ b/content/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps.md @@ -40,6 +40,14 @@ If you're interested in creating an app for {% data variables.product.prodname_m {% data reusables.marketplace.github_apps_preferred %}, although you can list both OAuth and {% data variables.product.prodname_github_apps %} in {% data variables.product.prodname_marketplace %}. For more information, see "[AUTOTITLE](/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)" and "[AUTOTITLE](/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps)." +### {% data variables.product.prodname_copilot_extensions %} + +{% data reusables.copilot.copilot-extensions.beta-note %} + +{% data reusables.copilot.copilot-extensions.copilot-extensions-intro %} + +To learn more about {% data variables.product.prodname_copilot_extensions_short %}, see "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions)." + ## Publishing an app to {% data variables.product.prodname_marketplace %} overview When you have finished creating your app, you can share it with other users by publishing it to {% data variables.product.prodname_marketplace %}. In summary, the process is: diff --git a/content/copilot/about-github-copilot.md b/content/copilot/about-github-copilot.md index 88b989a748d8..80e614969494 100644 --- a/content/copilot/about-github-copilot.md +++ b/content/copilot/about-github-copilot.md @@ -28,11 +28,11 @@ Using the chat feature, you can ask {% data variables.product.prodname_copilot_s - **Code completion** - {% data variables.product.prodname_copilot_short %} suggests code as you type. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/getting-started-with-github-copilot)." -- **Chat** - Ask {% data variables.product.prodname_copilot_short %} for help with your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide){% ifversion ghec %}" and "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% endif %}." +- **Chat** - Ask {% data variables.product.prodname_copilot_short %} for help with your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide){% ifversion ghec %}" and "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% endif %}." - **Pull request summaries** _({% data variables.product.prodname_copilot_enterprise_short %} only)_ - Get {% data variables.product.prodname_copilot_short %} to describe the changes in a pull request. For more information, see {% ifversion ghec %}"[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-pull-request-summaries/creating-a-pull-request-summary-with-github-copilot)."{% else %}"[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/about-copilot-pull-request-summaries)."{% endif %} -- **Knowledge bases** _({% data variables.product.prodname_copilot_enterprise_short %} only)_ - Create and manage collections of documentation to use as a context for chatting with {% data variables.product.prodname_copilot_short %}. For more information, see {% ifversion ghec %}"[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases)."{% else %}"[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases)."{% endif %} +- **Knowledge bases** _({% data variables.product.prodname_copilot_enterprise_short %} only)_ - Create and manage collections of documentation to use as a context for chatting with {% data variables.product.prodname_copilot_short %}. For more information, see {% ifversion ghec %}"[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases)."{% else %}"[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases)."{% endif %} For a full list of the features and functionality available on each {% data variables.product.prodname_copilot %} plan, see "[AUTOTITLE](/copilot/copilot-individual/github-copilot-individual-feature-set)", "[AUTOTITLE](/copilot/copilot-business/github-copilot-business-feature-set)", or "[AUTOTITLE](/copilot/github-copilot-enterprise/overview/github-copilot-enterprise-feature-set)." diff --git a/content/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile.md b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile.md similarity index 95% rename from content/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile.md index fe2cb5e3a3b0..5be13f0f347f 100644 --- a/content/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile.md @@ -3,12 +3,13 @@ title: About GitHub Copilot Chat in GitHub Mobile intro: '{% data variables.product.prodname_copilot_chat %} can help you by providing answers to coding related questions directly within {% data variables.product.prodname_mobile %}.' redirect_from: - /early-access/copilot/about-github-copilot-chat-in-github-mobile + - /copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile versions: feature: copilot-chat-for-mobile topics: - Copilot - Mobile -shortTitle: About Copilot Chat (Mobile) +shortTitle: About Copilot Chat type: rai --- diff --git a/content/copilot/github-copilot-chat/enabling-github-copilot-chat-for-github-mobile.md b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile.md similarity index 90% rename from content/copilot/github-copilot-chat/enabling-github-copilot-chat-for-github-mobile.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile.md index 0af9735c79fd..978aea9844e4 100644 --- a/content/copilot/github-copilot-chat/enabling-github-copilot-chat-for-github-mobile.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile.md @@ -6,7 +6,9 @@ topics: - Mobile versions: feature: copilot-chat-for-mobile -shortTitle: Enabling Copilot Chat (Mobile) +shortTitle: Enable Copilot Chat +redirect_from: + - /copilot/github-copilot-chat/enabling-github-copilot-chat-for-github-mobile --- If you have a {% data variables.product.prodname_copilot_for_individuals %} subscription, {% data variables.product.prodname_copilot_mobile %} is already enabled. @@ -34,4 +36,4 @@ An enterprise owner can choose whether to enable a feature for all organizations ## Next steps -You successfully enabled {% data variables.product.prodname_copilot_mobile_short %} for your organization{% ifversion ghec %} or enterprise{% endif %}. To learn more about how to use it, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile)." +You successfully enabled {% data variables.product.prodname_copilot_mobile_short %} for your organization{% ifversion ghec %} or enterprise{% endif %}. To learn more about how to use it, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile)." diff --git a/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/index.md b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/index.md new file mode 100644 index 000000000000..93bad7117aed --- /dev/null +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/index.md @@ -0,0 +1,10 @@ +--- +title: Copilot Chat in GitHub Mobile +intro: 'You can chat with {% data variables.product.prodname_copilot_chat_dotcom_short %} in {% data variables.product.prodname_mobile %} to learn out about aspects of software development, or to understand or improve specific lines of code.' +versions: + feature: 'copilot-chat-for-mobile' +children: + - /about-github-copilot-chat-in-github-mobile + - /enabling-github-copilot-chat-for-github-mobile + - /using-github-copilot-chat-in-github-mobile +--- diff --git a/content/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile.md b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile.md similarity index 95% rename from content/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile.md index f0e6891ffbb0..15bd8cfa816a 100644 --- a/content/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile.md @@ -6,14 +6,16 @@ topics: - Mobile versions: feature: copilot-chat-for-mobile -shortTitle: Use Copilot Chat (Mobile) +shortTitle: Use Copilot Chat +redirect_from: + - /copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile --- ## Overview -{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.product.prodname_copilot_chat %} {% ifversion ghec %}on either {% data variables.product.prodname_dotcom_the_website %} or{% endif %} within a supported IDE. For information on using {% data variables.product.prodname_copilot_chat %} in an IDE, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)." +{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.product.prodname_copilot_chat %} {% ifversion ghec %}on either {% data variables.product.prodname_dotcom_the_website %} or{% endif %} within a supported IDE. For information on using {% data variables.product.prodname_copilot_chat %} in an IDE, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)." -{% data variables.product.prodname_copilot_mobile_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile)." +{% data variables.product.prodname_copilot_mobile_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile)." {% ifversion ghec %} In {% data variables.product.prodname_mobile %}, you can use {% data variables.product.prodname_copilot_chat_short %} to ask: @@ -38,7 +40,7 @@ To use {% data variables.product.prodname_copilot_mobile_short %} you will need If you do not have a {% data variables.product.prodname_copilot %} subscription, you can purchase a {% data variables.product.prodname_copilot_individuals_short %} subscription directly in the iOS version of {% data variables.product.prodname_mobile %}, or in the Google Play Store for the Android version of {% data variables.product.prodname_mobile %}. -- **Access to {% data variables.product.prodname_copilot_mobile_short %}**: If you are part of an organization{% ifversion ghec %} or enterprise{% endif %} with a {% data variables.product.prodname_copilot_for_business %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise %}{% endif %} subscription, the organization{% ifversion ghec %} or enterprise{% endif %} owner will need to grant you access to {% data variables.product.prodname_copilot_cli_short %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/enabling-github-copilot-chat-for-github-mobile)." +- **Access to {% data variables.product.prodname_copilot_mobile_short %}**: If you are part of an organization{% ifversion ghec %} or enterprise{% endif %} with a {% data variables.product.prodname_copilot_for_business %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise %}{% endif %} subscription, the organization{% ifversion ghec %} or enterprise{% endif %} owner will need to grant you access to {% data variables.product.prodname_copilot_cli_short %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/enabling-github-copilot-chat-for-github-mobile)." - **Enable {% data variables.product.prodname_copilot_short %} features for your device**: {% data variables.product.prodname_copilot_short %} needs to be enabled from within {% data variables.product.prodname_mobile %}. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/getting-started-with-github-copilot#enabling-or-disabling-copilot-in-github-mobile)." ## Asking a general question about software development @@ -86,7 +88,7 @@ You can ask questions about a specific repository, to get help with understandin > [!IMPORTANT] > {% data variables.product.prodname_copilot_short %}'s ability to answer natural language questions like these in a repository context is improved when the repository has been indexed for semantic code search. However, only members of an enterprise with a {% data variables.product.prodname_copilot_enterprise %} subscription can index a repository for semantic code search. Without indexing, {% data variables.product.prodname_copilot_mobile_short %} may not be able to provide the most relevant answers to your questions. > - > Additionally, indexing a repository is not possible in {% data variables.product.prodname_mobile %}. To index a repository, you must use {% data variables.product.prodname_copilot_chat_short %} in a web browser. For more information, see step 6 of "[Asking a question about a specific repository, file or symbol](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)." + > Additionally, indexing a repository is not possible in {% data variables.product.prodname_mobile %}. To index a repository, you must use {% data variables.product.prodname_copilot_chat_short %} in a web browser. For more information, see step 6 of "[Asking a question about a specific repository, file or symbol](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)." {% data reusables.copilot.chat-mobile-conversation-buttons %} diff --git a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md b/content/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md similarity index 98% rename from content/copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md index eff210a61316..7a8bf8f71e9d 100644 --- a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom.md @@ -1,6 +1,6 @@ --- title: About GitHub Copilot Chat in GitHub.com -shortTitle: About Copilot Chat in GitHub.com +shortTitle: About Copilot Chat intro: '{% data variables.product.prodname_copilot_chat_dotcom %} can help you by providing answers to coding related questions directly within {% data variables.product.prodname_dotcom_the_website %}.' product: 'Owners of organizations {% ifversion ghec %}or enterprises {% endif %}with a {% data variables.product.prodname_copilot_enterprise %} subscription can decide whether to grant access to the {% data variables.product.prodname_copilot_enterprise_short %} functionality for an organization. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features)."' versions: @@ -12,6 +12,7 @@ type: rai redirect_from: - /copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat - /copilot/github-copilot-enterprise/copilot-docset-management/about-copilot-docset-management + - /copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom --- {% ifversion fpt %} @@ -154,7 +155,7 @@ When leveraging Bing, {% data variables.product.prodname_copilot_short %} will u For details of how to use {% data variables.product.prodname_copilot_chat_dotcom %}, see: -- "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} +- "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} ## Further reading diff --git a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/index.md b/content/copilot/github-copilot-chat/copilot-chat-in-github/index.md similarity index 52% rename from content/copilot/github-copilot-enterprise/copilot-chat-in-github/index.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github/index.md index 6f72e1a3b145..12dd203e728d 100644 --- a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/index.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github/index.md @@ -1,9 +1,11 @@ --- title: Copilot Chat in GitHub.com -intro: 'You can chat with {% data variables.product.prodname_copilot_chat_dotcom_short %} to learn out about aspects of software development, or to understand or improve specific lines of code.' +intro: 'You can chat with {% data variables.product.prodname_copilot_chat_dotcom_short %} in {% data variables.product.prodname_dotcom_the_website %} to learn out about aspects of software development, or to understand or improve specific lines of code.' versions: feature: 'copilot-on-dotcom' fpt: '*' +redirect_from: + - /copilot/github-copilot-enterprise/copilot-chat-in-github children: - /about-github-copilot-chat-in-githubcom - /using-github-copilot-chat-in-githubcom diff --git a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases.md b/content/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases.md similarity index 94% rename from content/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases.md index 05ffb83473f3..d7d0e0299a79 100644 --- a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases.md @@ -1,6 +1,6 @@ --- title: Managing Copilot knowledge bases -shortTitle: Managing knowledge bases +shortTitle: Manage knowledge bases intro: 'Organization owners can create a knowledge base bringing together Markdown documentation across one or more repositories, and then organization members can use that knowledge base as context for {% data variables.product.prodname_copilot_chat_dotcom_short %}.' versions: feature: copilot-private-docsets @@ -9,13 +9,14 @@ topics: redirect_from: - /copilot/github-copilot-enterprise/copilot-docset-management/creating-private-docsets - /copilot/github-copilot-enterprise/copilot-docset-management + - /copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases --- ## About knowledge bases Organization owners can create knowledge bases, bringing together Markdown documentation across one or more repositories. Organization members can then specify that knowledge base as the context for {% data variables.product.prodname_copilot_chat_dotcom_short %}. -When you ask a question in {% data variables.product.prodname_copilot_chat_dotcom_short %}, {% data variables.product.prodname_copilot %} will search the knowledge base for relevant information and synthesize a response. For more information on how to use knowledge bases in {% data variables.product.prodname_copilot_chat_dotcom_short %}, see "[Asking a question about a knowledge base](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom/#asking-a-question-about-a-knowledge-base)." +When you ask a question in {% data variables.product.prodname_copilot_chat_dotcom_short %}, {% data variables.product.prodname_copilot %} will search the knowledge base for relevant information and synthesize a response. For more information on how to use knowledge bases in {% data variables.product.prodname_copilot_chat_dotcom_short %}, see "[Asking a question about a knowledge base](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom/#asking-a-question-about-a-knowledge-base)." ## Creating a knowledge base diff --git a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md b/content/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md similarity index 98% rename from content/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md rename to content/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md index 7691a3a7de22..1a1f9d301012 100644 --- a/content/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom.md @@ -1,11 +1,13 @@ --- title: Using GitHub Copilot Chat in GitHub.com -shortTitle: Using Chat in GitHub.com +shortTitle: Use Copilot Chat intro: 'You can use {% data variables.product.prodname_copilot_chat_dotcom %} to answer general questions about software development, or specific questions about the issues or code in a repository.' versions: feature: 'copilot-on-dotcom' topics: - Copilot +redirect_from: + - /copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom --- ## Overview @@ -14,11 +16,11 @@ topics: {% note %} -**Note**: {% data variables.product.prodname_copilot_chat_short %} is also available in selected IDEs. For information on using {% data variables.product.prodname_copilot_chat %} in an IDE, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)." +**Note**: {% data variables.product.prodname_copilot_chat_short %} is also available in selected IDEs. For information on using {% data variables.product.prodname_copilot_chat %} in an IDE, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)." {% endnote %} -{% data variables.product.prodname_copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom)." +{% data variables.product.prodname_copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom)." On {% data variables.product.prodname_dotcom_the_website %}, you can use {% data variables.product.prodname_copilot_chat_short %} to ask: diff --git a/content/copilot/github-copilot-chat/about-github-copilot-chat.md b/content/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide.md similarity index 95% rename from content/copilot/github-copilot-chat/about-github-copilot-chat.md rename to content/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide.md index ca3b3dbdff72..d598de63a4f4 100644 --- a/content/copilot/github-copilot-chat/about-github-copilot-chat.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide.md @@ -1,16 +1,16 @@ --- title: About GitHub Copilot Chat in your IDE intro: '{% data variables.product.prodname_copilot_chat %} can help you by providing answers to coding related questions {% ifversion ghec %}on {% data variables.product.prodname_dotcom_the_website %} or{% endif %} directly within a supported IDE.' -allowTitleToDifferFromFilename: true redirect_from: - /early-access/copilot/github-copilot-chat-transparency-note - /early-access/copilot/github-copilot-chat-technical-preview-license-terms + - /copilot/github-copilot-chat/about-github-copilot-chat product: '{% data reusables.gated-features.copilot-chat-callout %}' versions: feature: copilot topics: - Copilot -shortTitle: About Copilot Chat (IDE) +shortTitle: About Copilot Chat type: rai --- @@ -40,7 +40,7 @@ The language model generates a response based on its analysis of the input promp The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat %}, see "[Improving performance for {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/about-github-copilot-chat#improving-performance-for-github-copilot-chat)." +{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat %}, see "[Improving performance for {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#improving-performance-for-github-copilot-chat)." ## Use cases for {% data variables.product.prodname_copilot_chat %} @@ -50,7 +50,7 @@ The response generated by {% data variables.product.prodname_copilot_chat_short {% data variables.product.prodname_copilot_chat_short %} can help you write unit test cases by generating code snippets based on the code open in the editor or the code snippet you highlight in the editor. This may help you write test cases without spending as much time on repetitive tasks. For example, if you are writing a test case for a specific function, you can use {% data variables.product.prodname_copilot_chat_short %} to suggest possible input parameters and expected output values based on the function's signature and body. {% data variables.product.prodname_copilot_chat_short %} can also suggest assertions that ensure the function is working correctly, based on the code's context and semantics. -{% data variables.product.prodname_copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.product.prodname_copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see "[Asking {% data variables.product.prodname_copilot_chat %} questions about your code](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code)." +{% data variables.product.prodname_copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.product.prodname_copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see "[Asking {% data variables.product.prodname_copilot_chat %} questions about your code](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code)." ### Explaining code and suggesting improvements @@ -72,7 +72,7 @@ You can ask {% data variables.product.prodname_copilot_chat_short %} for help or ## Improving performance for {% data variables.product.prodname_copilot_chat %} -{% data variables.product.prodname_copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the the limitations of {% data variables.product.prodname_copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.product.prodname_copilot_chat_short %}, see "[Limitations of {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/about-github-copilot-chat#limitations-of-github-copilot-chat)." +{% data variables.product.prodname_copilot_chat_short %} can support a wide range of practical applications like code generation, code analysis, and code fixes, each with different performance metrics and mitigation strategies. To enhance performance and address some of the the limitations of {% data variables.product.prodname_copilot_chat_short %}, there are various measures that you can adopt. For more information on the limitations of {% data variables.product.prodname_copilot_chat_short %}, see "[Limitations of {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#limitations-of-github-copilot-chat)." ### Keep your prompts on topic @@ -126,8 +126,8 @@ One of the limitations of {% data variables.product.prodname_copilot_chat_short For details of how to use {% data variables.product.prodname_copilot_chat %}, see: -- "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)" -- "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)" +- "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} ## Further reading diff --git a/content/copilot/github-copilot-chat/copilot-chat-in-ides/index.md b/content/copilot/github-copilot-chat/copilot-chat-in-ides/index.md new file mode 100644 index 000000000000..8c55bd588a3f --- /dev/null +++ b/content/copilot/github-copilot-chat/copilot-chat-in-ides/index.md @@ -0,0 +1,9 @@ +--- +title: Copilot Chat in IDEs +intro: 'You can chat with {% data variables.product.prodname_copilot_chat_dotcom_short %} in IDEs to learn out about aspects of software development, or to understand or improve specific lines of code.' +versions: + feature: 'copilot' +children: + - /about-github-copilot-chat-in-your-ide + - /using-github-copilot-chat-in-your-ide +--- diff --git a/content/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide.md b/content/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide.md similarity index 99% rename from content/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide.md rename to content/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide.md index cf4dbddfc2b0..6cf50ec7d76b 100644 --- a/content/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide.md +++ b/content/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide.md @@ -5,10 +5,11 @@ topics: - Copilot redirect_from: - /copilot/github-copilot-chat/using-github-copilot-chat + - /copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide defaultTool: vscode versions: feature: copilot -shortTitle: Use Copilot Chat (IDE) +shortTitle: Use Copilot Chat --- {% vscode %} diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions.md b/content/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions.md new file mode 100644 index 000000000000..2d86fd528a85 --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/about-github-copilot-extensions.md @@ -0,0 +1,39 @@ +--- +title: About GitHub Copilot Extensions +intro: '{% data variables.product.prodname_copilot_extensions %} are integrations for external tools in {% data variables.product.prodname_copilot_chat %}.' +product: '{% data reusables.gated-features.copilot-extensions %}' +versions: + feature: copilot-extensions +topics: + - Copilot +shortTitle: About Copilot Extensions +type: overview +--- + +{% data reusables.copilot.copilot-extensions.beta-note %} + +## About {% data variables.product.prodname_copilot_extensions %} + +{% data reusables.copilot.copilot-extensions.copilot-extensions-intro %} + +> [!NOTE] {% data variables.product.prodname_copilot_extensions %} are not the same as the {% data variables.product.prodname_copilot %} extension, which you install in an external application to access {% data variables.product.prodname_copilot_short %} within that application. For more information on the {% data variables.product.prodname_copilot %} extension, see "[AUTOTITLE](/copilot/using-github-copilot/getting-started-with-github-copilot)." + +After you install a {% data variables.product.prodname_copilot_extension_short %} from {% data variables.product.prodname_marketplace %}, you can interact with that extension in a {% data variables.product.prodname_copilot_chat_short %} conversation, asking questions and authorizing actions that combine the capabilities of the external tool and {% data variables.product.prodname_dotcom %}. For example, if you install the Sentry extension for {% data variables.product.prodname_copilot %}, you can use the extension to get information about Sentry issues, then create and assign related tracking issues on {% data variables.product.prodname_dotcom %}. + +{% data variables.product.prodname_copilot_extensions_short %} provide several benefits, including: + +- Interaction with external tools using natural language +- Reduced context switching +- Customization of your {% data variables.product.prodname_copilot_chat_short %} experience for your developer flow + +**{% data variables.product.prodname_copilot_extensions_short %} are included in all {% data variables.product.prodname_copilot_short %} subscriptions**, and can be used with: + +{% data reusables.copilot.copilot-extensions.compatible-chat-interfaces %} + +## Next steps + +If you have a {% data variables.product.prodname_copilot_individuals_short %} subscription, to get started with {% data variables.product.prodname_copilot_extensions_short %}, see "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account)." + +If you are an organization owner or enterprise administrator with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, you should set a policy for {% data variables.product.prodname_copilot_extension_short %} usage in your enterprise or organization. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions)." + +If you are a developer with {% data variables.product.prodname_copilot_short %} access through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, to get started with {% data variables.product.prodname_copilot_extensions_short %}, see "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions)." diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/index.md b/content/copilot/github-copilot-chat/github-copilot-extensions/index.md new file mode 100644 index 000000000000..0f49dac7538b --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/index.md @@ -0,0 +1,15 @@ +--- +title: GitHub Copilot Extensions +shortTitle: Copilot Extensions +intro: 'Learn about {% data variables.product.prodname_copilot_extensions %} (beta) and their uses.' +versions: + feature: copilot-extensions +topics: + - Copilot +children: + - /about-github-copilot-extensions + - /managing-github-copilot-extensions + - /installing-github-copilot-extensions-for-your-personal-account + - /installing-github-copilot-extensions-for-your-organization + - /using-github-copilot-extensions +--- diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization.md b/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization.md new file mode 100644 index 000000000000..70c92521448b --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization.md @@ -0,0 +1,34 @@ +--- +title: Installing GitHub Copilot Extensions for your organization +intro: 'You can install {% data variables.product.prodname_copilot_extensions %} for your organization from {% data variables.product.prodname_marketplace %}.' +product: 'Organization owners can install {% data variables.product.prodname_copilot_extensions %} for an organization.' +versions: + feature: copilot-extensions +topics: + - Copilot +shortTitle: Install organization extensions +type: how_to +--- + +{% data reusables.copilot.copilot-extensions.beta-note %} + +## About installing {% data variables.product.prodname_copilot_extensions %} for your organization + +Before you install any {% data variables.product.prodname_copilot_extensions_short %} in your organization, you should set a usage policy for {% data variables.product.prodname_copilot_extensions_short %} at the {% ifversion ghec %}enterprise or {% endif %}organization level. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions)." + +Any organization owner can install {% data variables.product.prodname_copilot_extensions_short %} for their organization, but your organization must meet the following criteria to use an installed {% data variables.product.prodname_copilot_extension_short %}: + +- Your organization is enrolled in the limited public beta for {% data variables.product.prodname_copilot_extensions_short %}. +- Your organization has an active {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription. + +> [!NOTE] Anyone can install a {% data variables.product.prodname_copilot_extension_short %} on their personal account. However, if they get access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, they will only be able to use the extension if it is installed at the organization level. + +## Installing {% data variables.product.prodname_copilot_extensions %} for your organization + +{% data reusables.copilot.copilot-extensions.copilot-extensions-on-marketplace %} + +To install a {% data variables.product.prodname_copilot_extension_short %} on an organization with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, see "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations)." + +## Next steps + +After installing a {% data variables.product.prodname_copilot_extension_short %} for your organization, developers in your organization can start using the extension. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions)." diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account.md b/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account.md new file mode 100644 index 000000000000..55bf196dd3f4 --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account.md @@ -0,0 +1,31 @@ +--- +title: Installing GitHub Copilot Extensions for your personal account +intro: 'You can install {% data variables.product.prodname_copilot_extensions %} for your personal account from {% data variables.product.prodname_marketplace %}.' +versions: + feature: copilot-extensions +topics: + - Copilot +shortTitle: Install personal extensions +type: how_to +--- + +{% data reusables.copilot.copilot-extensions.beta-note %} + +## About installing {% data variables.product.prodname_copilot_extensions %} for your personal account + +Anyone can install {% data variables.product.prodname_copilot_extensions_short %} for their personal account, but you must meet the following criteria to use a {% data variables.product.prodname_copilot_extension_short %} you install: + +- You are enrolled in the limited public beta for {% data variables.product.prodname_copilot_extensions_short %}. +- You have an active {% data variables.product.prodname_copilot_individuals_short %} subscription. + +> [!NOTE] If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, {% data variables.product.prodname_copilot_extensions_short %} are installed by organization owners at the organization level, and you do not need to install the extension on your personal account. To start using {% data variables.product.prodname_copilot_extensions_short %} installed in your organization, see "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions)." + +## Installing {% data variables.product.prodname_copilot_extensions %} for your personal account + +{% data reusables.copilot.copilot-extensions.copilot-extensions-on-marketplace %} + +To install a {% data variables.product.prodname_copilot_extension_short %} on your personal account, see "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account#installing-a-github-app-in-your-personal-account)." + +## Next steps + +After installing a {% data variables.product.prodname_copilot_extension_short %}, you can start using the extension in {% data variables.product.prodname_copilot_chat_short %}. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions)." diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions.md b/content/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions.md new file mode 100644 index 000000000000..ab93bd5c544a --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/managing-github-copilot-extensions.md @@ -0,0 +1,62 @@ +--- +title: Managing GitHub Copilot Extensions +intro: 'You can manage {% data variables.product.prodname_copilot_extension %} policies and permissions in your organization{% ifversion ghec %} or enterprise{% endif %}.' +product: 'Organization owners {% ifversion ghec %}and enterprise administrators {% endif %}can manage {% data variables.product.prodname_copilot_extensions_short %}.' +versions: + feature: copilot-extensions +topics: + - Copilot +shortTitle: Manage Copilot Extensions +type: how_to +--- + +{% data reusables.copilot.copilot-extensions.beta-note %} + +## About managing {% data variables.product.prodname_copilot_extensions %} + +Before you install {% data variables.product.prodname_copilot_extensions_short %} in your organization, you should set a usage policy for your {% ifversion ghec %}enterprise or {% endif %}organization. Setting a usage policy allows you to enable or disable {% data variables.product.prodname_copilot_extensions_short %} for all members of your {% ifversion ghec %}enterprise or {% endif %}organization, limiting your security risk. See {% ifversion ghec %}"[Setting a policy for {% data variables.product.prodname_copilot_extensions %} in your enterprise](#setting-a-policy-for-github-copilot-extensions-in-your-enterprise)" and {% endif %}"[Setting a policy for {% data variables.product.prodname_copilot_extensions %} in your organization](#setting-a-policy-for-github-copilot-extensions-in-your-organization)." + +Additionally, after you install a {% data variables.product.prodname_copilot_extension_short %} in your organization, you can view and manage the permissions for that extension. See "[Managing permissions for a {% data variables.product.prodname_copilot_extension %} in your organization](#managing-permissions-for-a-github-copilot-extension-in-your-organization)." + +{% ifversion ghec %} + +## Setting a policy for {% data variables.product.prodname_copilot_extensions %} in your enterprise + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.copilot-tab %} +{% data reusables.enterprise-accounts.copilot-policies-tab %} +1. In the "{% data variables.product.prodname_copilot_extensions_short %}" section, select the dropdown menu, then click one of the following options: + - **No policy**: organizations within your enterprise can set their own policies for {% data variables.product.prodname_copilot_extensions_short %}. + - **Enabled**: {% data variables.product.prodname_copilot_extensions_short %} are enabled for all organizations in your enterprise. + - **Disabled**: {% data variables.product.prodname_copilot_extensions_short %} are disabled for all organizations in your enterprise. + +{% endif %} + +## Setting a policy for {% data variables.product.prodname_copilot_extensions %} in your organization + +{% ifversion ghec %} +If {% data variables.product.prodname_copilot_extensions_short %} have not been enabled or disabled at the enterprise level, you can set a {% data variables.product.prodname_copilot_extensions_short %} policy for your organization. +{% endif %} + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.copilot.policy-settings %} +1. In the "{% data variables.product.prodname_copilot_extensions_short %}" section, select the dropdown menu, then enable or disable {% data variables.product.prodname_copilot_extensions_short %} for your organization. + +## Managing permissions for a {% data variables.product.prodname_copilot_extension %} in your organization + +After you have installed a {% data variables.product.prodname_copilot_extension_short %} in your organization, you can view the permissions the extension has in your organization, and why those permissions are necessary. If you do not want the {% data variables.product.prodname_copilot_extension_short %} to have the listed permissions, you can suspend or uninstall the extension. + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.apps.access-org-app-settings %} +1. Optionally, to filter your installed {% data variables.product.prodname_github_apps %} for {% data variables.product.prodname_copilot_extensions_short %}, select the **Filter:** dropdown menu, then click **{% data variables.product.prodname_copilot_extensions_short %}**. +1. Next to the {% data variables.product.prodname_copilot_extension_short %} you want to review or modify, click **Configure**. +1. In the "Permissions" section, review the permissions listed for the {% data variables.product.prodname_copilot_extension_short %}. Optionally, you can block the {% data variables.product.prodname_copilot_extension_short %}'s access to your organization in one of two ways: + - To indefinitely suspend the {% data variables.product.prodname_copilot_extension_short %}'s access to resources in your organization while keeping the extension installed, in the "Danger zone" section, click **Suspend**. + - To uninstall a {% data variables.product.prodname_copilot_extension_short %} completely, in the "Danger zone" section, click **Uninstall**. + +## Next steps + +After you have set a {% data variables.product.prodname_copilot_extensions_short %} policy, you can install {% data variables.product.prodname_copilot_extensions_short %} for your organization. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization)." diff --git a/content/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions.md b/content/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions.md new file mode 100644 index 000000000000..d11ad65ecda1 --- /dev/null +++ b/content/copilot/github-copilot-chat/github-copilot-extensions/using-github-copilot-extensions.md @@ -0,0 +1,50 @@ +--- +title: Using GitHub Copilot Extensions +intro: 'You can use {% data variables.product.prodname_copilot_extensions %} to interact with external tools in {% data variables.product.prodname_copilot_chat %}.' +product: '{% data reusables.gated-features.copilot-extensions %}' +versions: + feature: copilot-extensions +topics: + - Copilot +shortTitle: Use Copilot Extensions +type: how_to +--- + +{% data reusables.copilot.copilot-extensions.beta-note %} + +## About using {% data variables.product.prodname_copilot_extensions %} + +{% data variables.product.prodname_copilot_extensions_short %} **work the same way across all {% data variables.product.prodname_copilot_chat_short %} interfaces where {% data variables.product.prodname_copilot_extensions_short %} are available**. {% data variables.product.prodname_copilot_extensions_short %} are available in: + +{% data reusables.copilot.copilot-extensions.compatible-chat-interfaces %} + +If you have a {% data variables.product.prodname_copilot_individuals_short %} subscription, you need to install a {% data variables.product.prodname_copilot_extension_short %} before you can use the extension in {% data variables.product.prodname_copilot_chat_short %}. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-personal-account)." + +If you have access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, an organization owner needs to install {% data variables.product.prodname_copilot_extensions_short %} for your organization. See "[AUTOTITLE](/copilot/github-copilot-chat/github-copilot-extensions/installing-github-copilot-extensions-for-your-organization)." + +## Using {% data variables.product.prodname_copilot_extensions %} + +1. To start using a {% data variables.product.prodname_copilot_extension_short %}, open any of the following {% data variables.product.prodname_copilot_chat_short %} interfaces: + - {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}. See "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide?tool=vscode#asking-your-first-question)." + - {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %}. See "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide?tool=visualstudio#asking-your-first-question-1)."{% ifversion ghec %} + - {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %} (if you have a {% data variables.product.prodname_copilot_enterprise_short %} subscription). See "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-a-general-question-about-software-development)."{% endif %} +1. To see a list of all {% data variables.product.prodname_copilot_extensions_short %} available in your {% data variables.product.prodname_copilot_chat_short %} conversation, in the {% data variables.product.prodname_copilot_chat_short %} text box, type `@`. + + > [!NOTE] If you are using {% data variables.product.prodname_copilot_chat_short %} in an IDE, and you or your organization owner install a {% data variables.product.prodname_copilot_extension_short %} while your IDE is open, you need to restart your IDE to begin using the {% data variables.product.prodname_copilot_extension_short %}. + +1. In the list of available {% data variables.product.prodname_copilot_extensions_short %}, click the one you want to use. +1. To begin interacting with the {% data variables.product.prodname_copilot_extension_short %}, in the {% data variables.product.prodname_copilot_chat_short %} text box, ask the extension to answer a question or perform an action, then press Enter. For each new request, be sure to include `@EXTENSION-NAME` at the beginning of your sentence. + - If you did not install the {% data variables.product.prodname_copilot_extension_short %} yourself, and it is your first time using the {% data variables.product.prodname_copilot_extension_short %}, you will be asked to authorize the extension. See "[AUTOTITLE](/apps/using-github-apps/authorizing-github-apps)." + - If you ask a {% data variables.product.prodname_copilot_extension_short %} to perform an action, you need to confirm the extension has your permission to act on your behalf before it will complete the task. After carefully reviewing the proposed action, in the confirmation dialog, click **Allow** or **Dismiss**. + +## Tips for using {% data variables.product.prodname_copilot_extensions %} + +- When you are using a {% data variables.product.prodname_copilot_extension_short %}, consider how you would interact with the tool outside of {% data variables.product.prodname_copilot_chat_short %}, then use natural language to ask questions and assign tasks that integrate the capabilities of the tool with {% data variables.product.prodname_dotcom %}. For example, [Sentry](https://sentry.io/welcome/) is an application monitoring software with a {% data variables.product.prodname_copilot_extension_short %}. The following are some example prompts for the Sentry extension for {% data variables.product.prodname_copilot %}: + - `@sentry list my most recent issues` + - `@sentry tell me more about issue ISSUE-ID-OR-ISSUE-LINK` + - `@sentry create a {% data variables.product.prodname_dotcom %} issue for the most recent Sentry issue and assign it to @DEVELOPER` + + For information on the best ways to use a specific {% data variables.product.prodname_copilot_extension_short %}, read the description of the extension on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true). +- Interactions with one {% data variables.product.prodname_copilot_extension_short %} will never be shared with another {% data variables.product.prodname_copilot_extension_short %}. To interact with different {% data variables.product.prodname_copilot_extensions_short %} in an IDE, change the `@EXTENSION-NAME` at the beginning of each sentence. Interactions with different extensions will appear in the same {% data variables.product.prodname_copilot_chat_short %} window, but the conversations themselves are automatically separated. + + {% ifversion ghec %} To interact with different {% data variables.product.prodname_copilot_extensions_short %} on {% data variables.product.prodname_dotcom_the_website %}, you need to start a new conversation for each extension by clicking {% octicon "plus" aria-label="New conversation" %} at the top of the {% data variables.product.prodname_copilot_chat_short %} window.{% endif %} diff --git a/content/copilot/github-copilot-chat/index.md b/content/copilot/github-copilot-chat/index.md index 60f5d9696e1a..74f018d5ba5b 100644 --- a/content/copilot/github-copilot-chat/index.md +++ b/content/copilot/github-copilot-chat/index.md @@ -1,15 +1,14 @@ --- title: GitHub Copilot Chat shortTitle: Copilot Chat -intro: 'Learn about {% data variables.product.prodname_copilot_chat %}, including use cases, best practices, and limitations.' +intro: 'Learn about {% data variables.product.prodname_copilot_chat %}, including use cases, tools, best practices, and limitations.' versions: feature: copilot topics: - Copilot children: - - /about-github-copilot-chat-in-github-mobile - - /enabling-github-copilot-chat-for-github-mobile - - /using-github-copilot-chat-in-github-mobile - - /about-github-copilot-chat - - /using-github-copilot-chat-in-your-ide + - /copilot-chat-in-github + - /copilot-chat-in-ides + - /copilot-chat-in-github-mobile + - /github-copilot-extensions --- diff --git a/content/copilot/github-copilot-enterprise/index.md b/content/copilot/github-copilot-enterprise/index.md index 7403c8ad48f8..e90c8fc2af5e 100644 --- a/content/copilot/github-copilot-enterprise/index.md +++ b/content/copilot/github-copilot-enterprise/index.md @@ -8,6 +8,5 @@ versions: feature: copilot children: - /overview - - /copilot-chat-in-github - /copilot-pull-request-summaries --- diff --git a/content/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features.md b/content/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features.md index 13c487aafcf4..9ccaad2c0c71 100644 --- a/content/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features.md +++ b/content/copilot/github-copilot-enterprise/overview/enabling-github-copilot-enterprise-features.md @@ -77,7 +77,7 @@ After {% data variables.product.prodname_copilot_enterprise_short %} has been en 1. Index your organization's most popular repositories. - {% data variables.product.prodname_copilot_enterprise_short %} works best when repositories have semantic code indexing enabled. For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#repo-indexing-note). + {% data variables.product.prodname_copilot_enterprise_short %} works best when repositories have semantic code indexing enabled. For more information, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#repo-indexing-note). {% note %} @@ -89,7 +89,7 @@ After {% data variables.product.prodname_copilot_enterprise_short %} has been en 1. Create at least one knowledge base. - Knowledge bases bring together Markdown documentation across one or more repositories and make them available through {% data variables.product.prodname_copilot_enterprise_short %}. Once created, organization members can specify a knowledge base as the context for {% data variables.product.prodname_copilot_chat_dotcom_short %}. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/managing-copilot-knowledge-bases)." + Knowledge bases bring together Markdown documentation across one or more repositories and make them available through {% data variables.product.prodname_copilot_enterprise_short %}. Once created, organization members can specify a knowledge base as the context for {% data variables.product.prodname_copilot_chat_dotcom_short %}. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/managing-copilot-knowledge-bases)." ## Further reading diff --git a/content/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization.md b/content/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization.md index 8a2e7e722520..990ebab608ac 100644 --- a/content/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization.md +++ b/content/copilot/managing-github-copilot-in-your-organization/managing-policies-and-features-for-copilot-in-your-organization.md @@ -52,6 +52,6 @@ shortTitle: Managing policies - [{% data variables.product.prodname_copilot %} Trust Center](https://resources.github.com/copilot-trust-center) - "[AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions)" {% ifversion ghec %}- "[AUTOTITLE](/copilot/github-copilot-enterprise/overview/about-github-copilot-enterprise)"{% endif %} -- "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat)" -- "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat-in-github-mobile)" +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide)" +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile)" - "[AUTOTITLE](/copilot/github-copilot-in-the-cli/about-github-copilot-in-the-cli)" diff --git a/content/copilot/quickstart.md b/content/copilot/quickstart.md index 6c90af9cceb8..549f35f91f96 100644 --- a/content/copilot/quickstart.md +++ b/content/copilot/quickstart.md @@ -154,7 +154,7 @@ As an enterprise owner, you must decide whether to allow all organizations in yo - "[AUTOTITLE](/copilot/managing-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization)": As an organization owner, learn how to grant access to {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or{% endif %} {% data variables.product.prodname_copilot_business_short %} in your organization. - "[AUTOTITLE](/copilot/using-github-copilot/getting-started-with-github-copilot)": You've learned how to get your first suggestion in {% data variables.product.prodname_vscode %}. These guides show you how to set up and navigate the various functions of {% data variables.product.prodname_copilot %} across all of the supported environments. -- "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)"{% ifversion ghec %} and "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% endif %}: Find out how to ask {% data variables.product.prodname_copilot %} for information and assistance. +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)"{% ifversion ghec %} and "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% endif %}: Find out how to ask {% data variables.product.prodname_copilot %} for information and assistance. - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): See practical examples of how {% data variables.product.prodname_copilot %} can help you work. - "[AUTOTITLE](/copilot/configuring-github-copilot)": These guides provide details on how to configure {% data variables.product.prodname_copilot %} to your personal preferences. diff --git a/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat-in-ides.md b/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat-in-ides.md index db26dfc7bb6a..c45a20b1ef63 100644 --- a/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat-in-ides.md +++ b/content/copilot/troubleshooting-github-copilot/troubleshooting-issues-with-github-copilot-chat-in-ides.md @@ -14,9 +14,9 @@ redirect_from: - /copilot/troubleshooting-github-copilot/troubleshooting-authentication-issues-with-github-copilot-chat --- -If you need help with {% data variables.product.prodname_copilot_chat %} and can't find the answer here, you can report a bug or ask for help. For more information, see "[Sharing feedback about {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide#sharing-feedback-about-github-copilot-chat)." +If you need help with {% data variables.product.prodname_copilot_chat %} and can't find the answer here, you can report a bug or ask for help. For more information, see "[Sharing feedback about {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#sharing-feedback-about-github-copilot-chat)." -If you can't find {% data variables.product.prodname_copilot_chat %} in your editor, make sure you have checked the "[Prerequisites](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide#prerequisites)" section. +If you can't find {% data variables.product.prodname_copilot_chat %} in your editor, make sure you have checked the "[Prerequisites](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#prerequisites)" section. ## Troubleshooting authentication issues in your editor diff --git a/content/copilot/using-github-copilot/getting-started-with-github-copilot.md b/content/copilot/using-github-copilot/getting-started-with-github-copilot.md index 7040afcec2b4..64b02adcf3c3 100644 --- a/content/copilot/using-github-copilot/getting-started-with-github-copilot.md +++ b/content/copilot/using-github-copilot/getting-started-with-github-copilot.md @@ -617,8 +617,8 @@ You may not want to accept an entire suggestion from {% data variables.product.p {% data reusables.copilot.next-steps %} - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): See practical examples of how {% data variables.product.prodname_copilot %} can help you work. -- "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)"{% ifversion ghec %} and "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% endif %}: Find out how to ask {% data variables.product.prodname_copilot %} for information and assistance. -- "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile)": Learn how to use {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_mobile %}. +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)"{% ifversion ghec %} and "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% endif %}: Find out how to ask {% data variables.product.prodname_copilot %} for information and assistance. +- "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile)": Learn how to use {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_mobile %}. - "[AUTOTITLE](/copilot/configuring-github-copilot)": These guides provide details on how to configure {% data variables.product.prodname_copilot %} to your personal preferences. - "[AUTOTITLE](/billing/managing-billing-for-github-copilot)": Learn more about billing for {% data variables.product.prodname_copilot %}. - "[AUTOTITLE](/copilot/troubleshooting-github-copilot)": These guides provide information for troubleshooting {% data variables.product.prodname_copilot %}. diff --git a/content/get-started/using-github/github-mobile.md b/content/get-started/using-github/github-mobile.md index e84aee98ba20..820f1a21524b 100644 --- a/content/get-started/using-github/github-mobile.md +++ b/content/get-started/using-github/github-mobile.md @@ -36,7 +36,7 @@ The following documentation contains more information about using {% data variab - For more information about notifications for {% data variables.product.prodname_mobile %}, see "[AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#enabling-push-notifications-with-github-mobile)." {% ifversion mobile-code-search %}- For more information about using {% data variables.product.prodname_dotcom %} code search on {% data variables.product.prodname_mobile %}, see "[AUTOTITLE](/search-github/github-code-search/using-github-code-search#using-github-code-search-on-github-mobile)."{% endif %} {% ifversion fpt or ghec %}- For more information on two-factor authentication using {% data variables.product.prodname_mobile %}, see "[AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) and [Authenticating using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#verifying-with-github-mobile)." {% endif %} -{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.product.prodname_copilot_mobile %}, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile)."{% endif %} +{% ifversion copilot-chat-for-mobile %}- For more information about using {% data variables.product.prodname_copilot_mobile %}, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile)."{% endif %} ## Installing {% data variables.product.prodname_mobile %} diff --git a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md index 64701f782624..cb1a6effbde3 100644 --- a/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md +++ b/content/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request.md @@ -34,7 +34,7 @@ You can change the format of the diff view in this tab by clicking {% octicon "g You can also choose to hide whitespace differences. The choice you make only applies to this pull request and will be remembered the next time you visit this page. 1. Optionally, filter the files to show only the files you want to review{% ifversion pr-tree-view %} or use the file tree to navigate to a specific file{% endif %}. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/filtering-files-in-a-pull-request)." {%- ifversion ghec %} -1. Optionally, if you have access to {% data variables.product.prodname_copilot_enterprise %}, you can ask {% data variables.product.prodname_copilot_short %} about the changes in a file in a pull request by clicking {% octicon "kebab-horizontal" aria-label="Show options" %} at the top right of the file, clicking **Ask {% data variables.product.prodname_copilot_short %} about this diff**, then typing a request such as "Explain these changes." For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#finding-out-about-the-changes-in-a-pull-request)." +1. Optionally, if you have access to {% data variables.product.prodname_copilot_enterprise %}, you can ask {% data variables.product.prodname_copilot_short %} about the changes in a file in a pull request by clicking {% octicon "kebab-horizontal" aria-label="Show options" %} at the top right of the file, clicking **Ask {% data variables.product.prodname_copilot_short %} about this diff**, then typing a request such as "Explain these changes." For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#finding-out-about-the-changes-in-a-pull-request)." {%- endif %} {% data reusables.repositories.start-line-comment %} {% data reusables.repositories.multiple-lines-comment %} diff --git a/data/features/copilot-extensions.yml b/data/features/copilot-extensions.yml new file mode 100644 index 000000000000..968847e0a183 --- /dev/null +++ b/data/features/copilot-extensions.yml @@ -0,0 +1,6 @@ +# Reference: #13599 +# Copilot extensions (external tooling integrations for Copilot Chat) limited public beta + +versions: + fpt: '*' + ghec: '*' diff --git a/data/reusables/apps/access-org-app-settings.md b/data/reusables/apps/access-org-app-settings.md new file mode 100644 index 000000000000..d12deaa5786b --- /dev/null +++ b/data/reusables/apps/access-org-app-settings.md @@ -0,0 +1 @@ +1. In the sidebar, under "Third-party Access," click **{% data variables.product.prodname_github_apps %}**. A list of the {% data variables.product.prodname_github_apps %} installed on your organization will be displayed. diff --git a/data/reusables/copilot/chat-procedural-intro.md b/data/reusables/copilot/chat-procedural-intro.md index bd9781a190d7..fbefbdc8ade1 100644 --- a/data/reusables/copilot/chat-procedural-intro.md +++ b/data/reusables/copilot/chat-procedural-intro.md @@ -1,7 +1,7 @@ -{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions directly within a supported IDE. {% data variables.product.prodname_copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/about-github-copilot-chat)." +{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions directly within a supported IDE. {% data variables.product.prodname_copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide)." {% ifversion ghec %} -If you have a {% data variables.product.prodname_copilot_enterprise %} subscription you may also be able to use {% data variables.product.prodname_copilot_chat %} on {% data variables.product.prodname_dotcom_the_website %}, depending on your organization or enterprise settings. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)." +If you have a {% data variables.product.prodname_copilot_enterprise %} subscription you may also be able to use {% data variables.product.prodname_copilot_chat %} on {% data variables.product.prodname_dotcom_the_website %}, depending on your organization or enterprise settings. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)." {% endif %} diff --git a/data/reusables/copilot/copilot-enterprise-enable.md b/data/reusables/copilot/copilot-enterprise-enable.md index 6d81474df6c2..01e60c873eec 100644 --- a/data/reusables/copilot/copilot-enterprise-enable.md +++ b/data/reusables/copilot/copilot-enterprise-enable.md @@ -9,8 +9,8 @@ 1. If you select **Enabled**, two check boxes are displayed. - - **Give {% data variables.product.prodname_copilot_short %} access to Bing** - This is unselected by default. Select this check box to allow {% data variables.product.prodname_copilot_chat %} to use Bing search results to provide information for its responses. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-a-general-question-about-software-development)." - - **Opt in to user feedback collection** - This is selected by default. Clear this check box to prevent the display of the thumbs up and thumbs down feedback icons after {% data variables.product.prodname_copilot_short %} generates a pull request summary. If you opt in to collection of user feedback, when a user selects one of these icons, the pull request summary will be returned to {% data variables.product.prodname_dotcom %} to provide context for the user's feedback. If you clear this check box, the thumbs up and thumbs down feedback icons will still be displayed below each response in the {% data variables.product.prodname_copilot_chat_short %} panel, and users will still be able to submit written feedback to {% data variables.product.prodname_dotcom %} about {% data variables.product.prodname_copilot_short %} generally via the "Give feedback" link in the chat panel. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#sharing-feedback-about-github-copilot-chat-in-githubcom)." + - **Give {% data variables.product.prodname_copilot_short %} access to Bing** - This is unselected by default. Select this check box to allow {% data variables.product.prodname_copilot_chat %} to use Bing search results to provide information for its responses. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#asking-a-general-question-about-software-development)." + - **Opt in to user feedback collection** - This is selected by default. Clear this check box to prevent the display of the thumbs up and thumbs down feedback icons after {% data variables.product.prodname_copilot_short %} generates a pull request summary. If you opt in to collection of user feedback, when a user selects one of these icons, the pull request summary will be returned to {% data variables.product.prodname_dotcom %} to provide context for the user's feedback. If you clear this check box, the thumbs up and thumbs down feedback icons will still be displayed below each response in the {% data variables.product.prodname_copilot_chat_short %} panel, and users will still be able to submit written feedback to {% data variables.product.prodname_dotcom %} about {% data variables.product.prodname_copilot_short %} generally via the "Give feedback" link in the chat panel. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom#sharing-feedback-about-github-copilot-chat-in-githubcom)." {% note %} diff --git a/data/reusables/copilot/copilot-enterprise-features.md b/data/reusables/copilot/copilot-enterprise-features.md index 7a37689d8c8f..2fca4b0e3c1c 100644 --- a/data/reusables/copilot/copilot-enterprise-features.md +++ b/data/reusables/copilot/copilot-enterprise-features.md @@ -1,6 +1,6 @@ ### {% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_dotcom_the_website %} -{% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_dotcom_the_website %} is a chat interface that lets you ask and receive answers to coding-related questions within {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat-in-githubcom)." +{% data variables.product.prodname_copilot_chat %} in {% data variables.product.prodname_dotcom_the_website %} is a chat interface that lets you ask and receive answers to coding-related questions within {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github/about-github-copilot-chat-in-githubcom)." ### {% data variables.product.prodname_copilot_for_prs %} diff --git a/data/reusables/copilot/copilot-extensions/beta-note.md b/data/reusables/copilot/copilot-extensions/beta-note.md new file mode 100644 index 000000000000..437998946480 --- /dev/null +++ b/data/reusables/copilot/copilot-extensions/beta-note.md @@ -0,0 +1 @@ +> [!NOTE] {% data variables.product.prodname_copilot_extensions %} are in limited public beta and subject to change. diff --git a/data/reusables/copilot/copilot-extensions/compatible-chat-interfaces.md b/data/reusables/copilot/copilot-extensions/compatible-chat-interfaces.md new file mode 100644 index 000000000000..a6fc59bf2aab --- /dev/null +++ b/data/reusables/copilot/copilot-extensions/compatible-chat-interfaces.md @@ -0,0 +1,3 @@ +- {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vs %} +- {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %} +- {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_dotcom_the_website %} (with a {% data variables.product.prodname_copilot_enterprise_short %} subscription) diff --git a/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md b/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md new file mode 100644 index 000000000000..82a9738e7eac --- /dev/null +++ b/data/reusables/copilot/copilot-extensions/copilot-extensions-intro.md @@ -0,0 +1 @@ +{% data variables.product.prodname_copilot_extensions %} are **a type of {% data variables.product.prodname_github_app %} that integrates the power of external tools into {% data variables.product.prodname_copilot_chat %}**. {% data variables.product.prodname_copilot_extensions_short %} are developed by {% data variables.copilot.copilot_partners %}, a group of external tools selected by {% data variables.product.company_short %} for their utility when integrated into {% data variables.product.prodname_copilot_chat_short %}. To become a {% data variables.copilot.copilot_partner %}, you can apply to the [{% data variables.copilot.copilot_partner_program %}](https://github.com/features/preview/copilot-partner-program). diff --git a/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md b/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md new file mode 100644 index 000000000000..4dbc1273045a --- /dev/null +++ b/data/reusables/copilot/copilot-extensions/copilot-extensions-on-marketplace.md @@ -0,0 +1 @@ +{% data variables.product.prodname_copilot_extensions_short %} are a type of {% data variables.product.prodname_github_app %}, and can be installed from {% data variables.product.prodname_marketplace %}. You can discover available {% data variables.product.prodname_copilot_extensions_short %} by opening [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&copilot_app=true), then clicking {% octicon "copilot" aria-hidden="true" %} **{% data variables.product.prodname_copilot_extensions_short %}** in the sidebar. diff --git a/data/reusables/copilot/copilot-individual-features.md b/data/reusables/copilot/copilot-individual-features.md index b34ded0f9cc5..c7ebc6cbf488 100644 --- a/data/reusables/copilot/copilot-individual-features.md +++ b/data/reusables/copilot/copilot-individual-features.md @@ -4,11 +4,11 @@ ### {% data variables.product.prodname_copilot_mobile %} -{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-github-mobile)." +{% data variables.product.prodname_copilot_mobile %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within {% data variables.product.prodname_mobile %}. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/using-github-copilot-chat-in-github-mobile)." ### {% data variables.product.prodname_copilot_chat %} in your IDE -{% data variables.product.prodname_copilot_chat %} in your IDE is a chat interface that lets you ask and receive answers to coding-related questions within supported IDEs. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/using-github-copilot-chat-in-your-ide)." +{% data variables.product.prodname_copilot_chat %} in your IDE is a chat interface that lets you ask and receive answers to coding-related questions within supported IDEs. For more information, see "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)." ### {% data variables.product.prodname_copilot_cli %} diff --git a/data/reusables/enterprise-accounts/copilot-tab.md b/data/reusables/enterprise-accounts/copilot-tab.md index 6054c1e6701e..1e5409ba4a58 100644 --- a/data/reusables/enterprise-accounts/copilot-tab.md +++ b/data/reusables/enterprise-accounts/copilot-tab.md @@ -1 +1 @@ -1. Under "{% octicon "law" aria-hidden="true" %} Policies", click **{% data variables.product.prodname_copilot_short %}**. +1. In the "{% octicon "law" aria-hidden="true" %} Policies" section, click **{% data variables.product.prodname_copilot_short %}**. diff --git a/data/reusables/gated-features/copilot-extensions.md b/data/reusables/gated-features/copilot-extensions.md new file mode 100644 index 000000000000..9094f6b816f0 --- /dev/null +++ b/data/reusables/gated-features/copilot-extensions.md @@ -0,0 +1,5 @@ +To use {% data variables.product.prodname_copilot_extensions_short %}, you must be enrolled in the limited public beta. + +All enrolled users with a {% data variables.product.prodname_copilot_for_individuals %} subscription can use {% data variables.product.prodname_copilot_extensions_short %}. + +For enrolled organizations or enterprises with a {% data variables.product.prodname_copilot_business_short %} or {% data variables.product.prodname_copilot_enterprise_short %} subscription, organization owners and enterprise administrators can grant access to {% data variables.product.prodname_copilot_extensions_short %}. diff --git a/data/reusables/marketplace/visit-marketplace.md b/data/reusables/marketplace/visit-marketplace.md index 1e7e34b657fe..9375295891bc 100644 --- a/data/reusables/marketplace/visit-marketplace.md +++ b/data/reusables/marketplace/visit-marketplace.md @@ -1,9 +1,3 @@ 1. To open {% data variables.product.prodname_marketplace %}, in the top-left corner of {% data variables.location.product_location %}, select {% octicon "three-bars" aria-label="Open global navigation menu" %}, then click {% octicon "gift" aria-hidden="true" %} **Marketplace**. ![Screenshot of the navigation bar on {% data variables.product.product_name %}. The "Open global navigation menu" icon is outlined in dark orange.](/assets/images/help/navigation/global-navigation-menu-icon.png) - - {% note %} - - **Note**: This step refers to the new global navigation, which is currently in public beta and subject to change. For more information on the new global navigation and reverting to the old global navigation, see the [{% data variables.product.prodname_dotcom %} Changelog](https://github.blog/changelog/2023-06-15-redesigned-navigation-enabled-for-all-users-beta/). - - {% endnote %} diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index c30376b58dff..b03f0f086a99 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -14,3 +14,8 @@ ce_price_per_month: '$39 USD' # Copilot Chat in GitHub.com: maximum number of repos that can be indexed for an org max-chat-indexed-repos: '50' + +# Copilot partners: builders who can develop Copilot extensions +copilot_partners: 'Copilot Partners' +copilot_partner: 'Copilot Partner' +copilot_partner_program: 'Copilot Partner Program' diff --git a/data/variables/product.yml b/data/variables/product.yml index 44008a4179df..8f01dcba9d4a 100644 --- a/data/variables/product.yml +++ b/data/variables/product.yml @@ -266,6 +266,10 @@ prodname_copilot_chat_dotcom: 'GitHub Copilot Chat in GitHub.com' prodname_copilot_chat_dotcom_short: 'Copilot Chat in GitHub.com' prodname_copilot_mobile: 'GitHub Copilot Chat in GitHub Mobile' prodname_copilot_mobile_short: 'Copilot Chat in GitHub Mobile' +prodname_copilot_extensions: 'GitHub Copilot Extensions' +prodname_copilot_extension: 'GitHub Copilot Extension' +prodname_copilot_extensions_short: 'Copilot Extensions' +prodname_copilot_extension_short: 'Copilot Extension' prodname_copilot_cli: 'GitHub Copilot in the CLI' prodname_copilot_cli_short: 'Copilot in the CLI' prodname_copilot_for_prs: 'Copilot pull request summaries'