Repo sync

content/copilot/concepts/code-review.md → content/copilot/concepts/agents/code-review.md

@@ -10,6 +10,7 @@ topics:
 redirect_from:
   - /copilot/code-review
   - /copilot/concepts/code-review/code-review
+  - /copilot/concepts/code-review
 contentType: concepts
 ---
 

content/copilot/concepts/coding-agent/coding-agent.md → content/copilot/concepts/agents/coding-agent/about-coding-agent.md

@@ -1,7 +1,7 @@
 ---
 title: About GitHub Copilot coding agent
-shortTitle: Coding agent
-intro: 'You can assign {% data variables.product.github %} issues to {% data variables.product.prodname_copilot_short %}, or ask {% data variables.product.prodname_copilot_short %} to create a pull request.'
+shortTitle: About coding agent
+intro: You can assign {% data variables.product.github %} issues to {% data variables.product.prodname_copilot_short %}, or ask {% data variables.product.prodname_copilot_short %} to create a pull request.
 product: '{% data reusables.gated-features.copilot-coding-agent %}<br><a href="https://github.com/features/copilot/plans?ref_cta=Copilot+plans+signup&ref_loc=about+assigning+issues+to+copilot&ref_page=docs" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
 versions:
   feature: copilot
@@ -15,6 +15,7 @@ redirect_from:
   - /copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot
   - /copilot/concepts/about-copilot-coding-agent
   - /copilot/concepts/coding-agent/about-copilot-coding-agent
+  - /copilot/concepts/coding-agent/coding-agent
 contentType: concepts
 ---
 

content/copilot/concepts/coding-agent/enable-coding-agent.md → content/copilot/concepts/agents/coding-agent/coding-agent-for-business-and-enterprise.md

@@ -1,8 +1,8 @@
 ---
-title: About enabling GitHub Copilot coding agent
-shortTitle: 'Enable {% data variables.copilot.copilot_coding_agent_short %}'
+title: About GitHub Copilot coding agent for business and enterprise
+shortTitle: Business and enterprise
 allowTitleToDifferFromFilename: true
-intro: 'Find out about enabling {% data variables.copilot.copilot_coding_agent %} for {% data variables.copilot.copilot_enterprise %} and {% data variables.copilot.copilot_for_business %}, and about disabling the agent for specific repositories.'
+intro: Find out about {% data variables.copilot.copilot_coding_agent %} policies available for {% data variables.copilot.copilot_enterprise %} and {% data variables.copilot.copilot_for_business %}, and about disabling the agent for specific repositories.
 product: '{% data reusables.gated-features.copilot-coding-agent %}<br><a href="https://github.com/features/copilot/plans?ref_cta=Copilot+plans+signup&ref_loc=enabling+copilot+coding+agent&ref_page=docs" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
 versions:
   feature: copilot
@@ -14,6 +14,8 @@ redirect_from:
   - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/enabling-copilot-coding-agent-for-your-personal-repositories
   - /copilot/using-github-copilot/coding-agent/enabling-copilot-coding-agent
   - /copilot/concepts/coding-agent/about-enabling-coding-agent
+  - /copilot/concepts/coding-agent/enable-coding-agent
+  - /copilot/concepts/agents/coding-agent/enable-coding-agent
 contentType: concepts
 ---
 
@@ -32,7 +34,7 @@ If you are a {% data variables.copilot.copilot_pro %} or Pro+ subscriber, {% dat
 
 Once enabled, you can use {% data variables.copilot.copilot_coding_agent %} in any repository, provided that an administrator hasn't opted the repository out.
 
-## Enabling {% data variables.copilot.copilot_coding_agent %} for {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %} subscribers
+## {% data variables.copilot.copilot_coding_agent %} policies for {% data variables.copilot.copilot_business_short %} and {% data variables.copilot.copilot_enterprise_short %}
 
 {% data reusables.copilot.coding-agent.enabling-for-orgs-and-enterprises %}
 

content/copilot/concepts/coding-agent/index.md → content/copilot/concepts/agents/coding-agent/index.md

@@ -2,16 +2,18 @@
 title: Concepts for GitHub Copilot coding agent
 shortTitle: '{% data variables.copilot.copilot_coding_agent_short_cap_c %}'
 allowTitleToDifferFromFilename: true
-intro: 'Learn how {% data variables.copilot.copilot_coding_agent %} can carry out coding tasks for you, working independently in the same workflow you use yourself.'
+intro: Learn how {% data variables.copilot.copilot_coding_agent %} can carry out coding tasks for you, working independently in the same workflow you use yourself.
 versions:
   feature: copilot
 topics:
   - Copilot
 children:
-  - /coding-agent
-  - /enable-coding-agent
+  - /about-coding-agent
+  - /coding-agent-for-business-and-enterprise
   - /mcp-and-coding-agent
 contentType: concepts
+redirect_from:
+  - /copilot/concepts/coding-agent
 ---
 
 These articles provide an overview of {% data variables.copilot.copilot_coding_agent %}. For instructions on configuring and using {% data variables.copilot.copilot_coding_agent %}, see the how-to articles under [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent).

content/copilot/concepts/coding-agent/mcp-and-coding-agent.md → content/copilot/concepts/agents/coding-agent/mcp-and-coding-agent.md

@@ -1,13 +1,15 @@
 ---
 title: Model Context Protocol (MCP) and GitHub Copilot coding agent
-shortTitle: 'MCP and {% data variables.copilot.copilot_coding_agent_short %}'
+shortTitle: MCP and {% data variables.copilot.copilot_coding_agent_short %}
 allowTitleToDifferFromFilename: true
-intro: 'Find out about using the Model Context Protocol (MCP) with {% data variables.copilot.copilot_coding_agent %}.'
+intro: Find out about using the Model Context Protocol (MCP) with {% data variables.copilot.copilot_coding_agent %}.
 versions:
   feature: copilot
 topics:
   - Copilot
 contentType: concepts
+redirect_from:
+  - /copilot/concepts/coding-agent/mcp-and-coding-agent
 ---
 
 > [!NOTE]

content/copilot/concepts/agents/index.md

@@ -0,0 +1,15 @@
+---
+title: Concepts for GitHub Copilot agents
+shortTitle: Agents
+allowTitleToDifferFromFilename: true
+intro: Learn how {% data variables.product.prodname_copilot %} can independently execute tasks across the software development lifecycle.
+versions:
+  feature: copilot
+topics:
+  - Copilot
+children:
+  - /coding-agent
+  - /code-review
+contentType: concepts
+---
+

content/copilot/concepts/content-exclusion.md → content/copilot/concepts/context/content-exclusion.md

@@ -1,14 +1,15 @@
 ---
 title: Content exclusion for GitHub Copilot
 shortTitle: Content exclusion
-intro: 'You can prevent {% data variables.product.prodname_copilot_short %} from accessing certain files.'
+intro: You can prevent {% data variables.product.prodname_copilot_short %} from accessing certain files.
 product: '{% data reusables.gated-features.copilot-business-and-enterprise %}'
 versions:
   feature: copilot
 topics:
   - Copilot
 redirect_from:
   - /copilot/concepts/content-exclusion-for-github-copilot
+  - /copilot/concepts/content-exclusion
 contentType: concepts
 ---
 

content/copilot/concepts/context/copilot-extensions.md

@@ -0,0 +1,83 @@
+---
+title: About GitHub Copilot Extensions
+shortTitle: Copilot extensions
+intro: 'Learn about {% data variables.copilot.copilot_extensions_short %}.'
+allowTitleToDifferFromFilename: true
+product: '{% data reusables.gated-features.copilot-extensions %}'
+versions:
+  feature: copilot-extensions
+topics:
+  - Copilot
+redirect_from:
+  - /copilot/reference/copilot-extensions/copilot-extensions-faq
+  - /copilot/reference/copilot-extensions
+  - /copilot/concepts/copilot-extensions/about-copilot-extensions
+  - /copilot/concepts/copilot-extensions/about-extensions
+contentType: concepts
+---
+
+## About {% data variables.copilot.copilot_extensions_short %}
+
+{% data reusables.copilot.copilot-extensions.about-copilot-extensions %}
+
+## Supported clients and IDEs
+
+{% data reusables.copilot.copilot-extensions.supported-clients-and-ides-table %}
+
+## Visibility of {% data variables.copilot.copilot_extensions %}
+
+{% data variables.copilot.copilot_extensions %} can be private, public and shareable, or public and listed on the {% data variables.product.prodname_marketplace %}. Which visibility option you choose will depend on your use case and the audience you are targeting.
+
+* Private extensions are often preferred by large enterprises or companies that:
+    * Want more customization and controls over data access
+    * Need to integrate with a large volume of internal documents and databases
+    * Have strict security policies making it difficult to authorize permissions for third-parties
+* Public extensions are suitable for:
+    * Open-source projects
+    * Collaborative development and use across organizations within an enterprise
+    * Sharing your tool and getting feedback before publishing to the {% data variables.product.prodname_marketplace %}
+* {% data variables.product.prodname_marketplace %} extensions are ideal for third-parties that want to:
+    * Offer their service to a broader audience
+    * Integrate their tool into the developer workflow on {% data variables.product.company_short %} and the IDE
+    * Leverage the {% data variables.product.company_short %} ecosystem to raise awareness for their product
+
+## {% data variables.copilot.copilot_extensions %} permissions
+
+Permissions vary by extension, depending on the level of authorization that the extension requires in order to respond to your query. You can view the required permissions on the extension’s installation page, located after the billing information step and before the install and authorize step.
+
+**For extension users**: At a minimum, the **{% data variables.copilot.copilot_chat_short %}** permissions must be set to "Read-only". Additional permissions may include executing write actions on other surfaces and authorizing read access to repository and organization level data in {% data variables.product.github %}.
+
+**For extension creators**: In addition to the above, you may also request local context from a user’s editor to further tailor responses. To do so, the **{% data variables.product.prodname_copilot_short %} Editor Context** permissions must be set to "Read-only". Users will be notified to provide the required authorization.
+
+For more information on {% data variables.product.prodname_github_app %} permissions, see [AUTOTITLE](/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app).
+
+### Granting permissions to access organization resources
+
+Users with an individual {% data variables.product.prodname_copilot_short %} subscription can install and use {% data variables.copilot.copilot_extensions_short %}. Users with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription need an organization administrator to enable this feature.
+
+Only organization administrators can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources.
+
+To grant organization members access, the organization administrator must:
+
+* Install the extension
+* Grant the extension permission to access specific repositories
+* Authorize access for all, or specific repositories
+
+### Controlling access at the enterprise level
+
+If you are an enterprise administrator, you can disable {% data variables.copilot.copilot_extensions_short %} across your enterprise by setting the **{% data variables.copilot.copilot_extensions_short %}** policy to "Disabled". The "No Policy" setting allows organization administrators to set their own policy.
+
+No, there is no allowlist or blocklist at the enterprise level.
+
+## Sharing data with {% data variables.copilot.copilot_extensions_short %}
+
+The following data is shared when you interact with {% data variables.copilot.copilot_extensions_short %}:
+
+* Data attached to your account and {% data variables.copilot.copilot_chat_short %} usage, such as {% data variables.product.github %} user ID, and timestamps of messages.
+* Past messages within the chat thread where you are invoking an extension. Only one extension can be used per thread, preventing data sharing across extensions. The data retention period for thread context is 30 days.
+* Any additional organization and repository data that is authorized for the extension by your organization administrator. Administrators installing extensions must approve access to the required permissions prior to completing installation.
+* For {% data variables.copilot.copilot_chat_dotcom_short %}, if your administrator has approved the extension to access repository or organization metadata, that data will be shared as well.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/extensions/build-extensions)

content/copilot/concepts/context/index.md

@@ -0,0 +1,19 @@
+---
+title: Concepts for providing context to GitHub Copilot
+shortTitle: Context
+allowTitleToDifferFromFilename: true
+intro: Learn how {% data variables.product.prodname_copilot %} gathers contextual information to provide relevant responses to your prompts.
+versions:
+  feature: copilot
+topics:
+  - Copilot
+children:
+  - /mcp
+  - /spaces
+  - /repository-indexing
+  - /content-exclusion
+  - /knowledge-bases
+  - /copilot-extensions
+contentType: concepts
+---
+

content/copilot/concepts/knowledge-bases.md → content/copilot/concepts/context/knowledge-bases.md

@@ -1,7 +1,7 @@
 ---
 title: GitHub Copilot knowledge bases
 shortTitle: Knowledge bases
-intro: 'Knowledge bases allow you to bring together Markdown documentation across one or more repositories, which can then be used as context for {% data variables.copilot.copilot_chat_short %}.'
+intro: Knowledge bases allow you to bring together Markdown documentation across one or more repositories, which can then be used as context for {% data variables.copilot.copilot_chat_short %}.
 versions:
   fpt: '*'
   ghec: '*'
@@ -10,16 +10,17 @@ topics:
   - Copilot
 redirect_from:
   - /copilot/concepts/copilot-knowledge-bases
+  - /copilot/concepts/knowledge-bases
 contentType: concepts
 ---
 
-<!-- expires 2025-09-11 -->
+<!-- expires 2025-10-31 -->
 
 <!-- When this expires, check with the stakeholder for release #6165 if the knowledge bases content can be deleted -->
 
->[!IMPORTANT] Beginning September 12, 2025, knowledge bases will be {% data variables.release-phases.retired %} and fully replaced by {% data variables.copilot.copilot_spaces %}. {% data variables.copilot.copilot_spaces_short %} let you combine code and free-text content—like transcripts or specs—and can be created by any {% data variables.product.prodname_copilot_short %} user, not just organization owners. They’re a good option for more focused or task-specific use cases. See [AUTOTITLE](/copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces).
+{% data reusables.copilot.knowledge-bases-retirement %}
 
-<!-- end expires 2025-09-11 -->
+<!-- end expires 2025-10-31 -->
 
 ## About knowledge bases
 

content/copilot/concepts/about-mcp.md → content/copilot/concepts/context/mcp.md

@@ -1,13 +1,15 @@
 ---
 title: About Model Context Protocol (MCP)
 allowTitleToDifferFromFilename: true
-shortTitle: About MCP
-intro: 'Model Context Protocol (MCP) is a protocol that allows you to extend the capabilities of {% data variables.product.prodname_copilot %} by integrating it with other systems.'
+shortTitle: MCP
+intro: Model Context Protocol (MCP) is a protocol that allows you to extend the capabilities of {% data variables.product.prodname_copilot %} by integrating it with other systems.
 versions:
   feature: copilot
 topics:
   - Copilot
 contentType: concepts
+redirect_from:
+  - /copilot/concepts/about-mcp
 ---
 
 ## Overview of Model Context Protocol (MCP)

content/copilot/concepts/repository-indexes.md → content/copilot/concepts/context/repository-indexing.md

@@ -1,6 +1,6 @@
 ---
 title: Indexing repositories for GitHub Copilot Chat
-shortTitle: Repository indexes
+shortTitle: Repository indexing
 intro: '{% data variables.copilot.copilot_chat %} improves responses to questions about code by indexing your repositories.'
 versions:
   feature: copilot
@@ -14,6 +14,7 @@ redirect_from:
   - /copilot/using-github-copilot/indexing-repositories-for-copilot-chat
   - /copilot/using-github-copilot/copilot-chat/indexing-repositories-for-copilot-chat
   - /copilot/concepts/indexing-repositories-for-copilot-chat
+  - /copilot/concepts/repository-indexes
 contentType: concepts
 ---
 

content/copilot/concepts/spaces.md → content/copilot/concepts/context/spaces.md

@@ -1,15 +1,16 @@
 ---
 title: About organizing and sharing context with GitHub Copilot Spaces
 shortTitle: Spaces
-intro: 'Understand how gathering context with {% data variables.copilot.copilot_spaces %} can improve your results and help your teammates.'
-permissions: 'Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.'
+intro: Understand how gathering context with {% data variables.copilot.copilot_spaces %} can improve your results and help your teammates.
+permissions: Anyone with a {% data variables.product.prodname_copilot_short %} license can use {% data variables.copilot.copilot_spaces_short %}.
 versions:
   feature: copilot
 topics:
   - Copilot
 redirect_from:
   - /copilot/using-github-copilot/copilot-spaces/about-organizing-and-sharing-context-with-copilot-spaces
   - /copilot/concepts/about-organizing-and-sharing-context-with-copilot-spaces
+  - /copilot/concepts/spaces
 contentType: concepts
 ---