chore(repo): sync from inner source

Sync from github/github-well-architected-internal (main)

Source Repository: github/github-well-architected-internal

Source Branch: main

Source SHA: 323a37b44a05c5eb889dd882598c1ae5dadabbad

Co-authored-by: well-architected-sync-bot[bot] <235114805+well-architected-sync-bot[bot]@users.noreply.github.com>

Author: well-architected-sync-bot[bot]

content/library/overview/release-notes/2026-q2.md

@@ -2,9 +2,9 @@
 
 ## 2026 Q2
 
-- **New Content: [Governing agents in GitHub Enterprise](/library/governance/recommendations/governing-agents/)** - Published governance and policy guidance for managing GitHub Copilot agents across the enterprise, covering policy configuration, security boundaries, MCP server governance, and audit pipelines
-- **New Content: [Essentials of governance and administration with GitHub Enterprise](/library/governance/recommendations/governance-administration-essentials/)** - Published a comprehensive guide for enterprise governance and administration fundamentals, covering GitHub structural components, user access models, org architecture strategies, policy baselines, and operational topics such as integrations, roles, and audit logging
-- **New Content: [Managing AI credits](/library/governance/recommendations/managing-ai-credits/)** - Published a FinOps-oriented guide for governing AI credit consumption across GitHub Enterprise, covering layered budgets design, cost attribution, usage guidance, and an operating cadence
+- **New Content: [Governing agents in GitHub Enterprise](../governance/recommendations/governing-agents)** - Published governance and policy guidance for managing GitHub Copilot agents across the enterprise, covering policy configuration, security boundaries, MCP server governance, and audit pipelines
+- **New Content: [Essentials of governance and administration with GitHub Enterprise](../governance/recommendations/governance-administration-essentials)** - Published a comprehensive guide for enterprise governance and administration fundamentals, covering GitHub structural components, user access models, org architecture strategies, policy baselines, and operational topics such as integrations, roles, and audit logging
+- **New Content: [Managing AI credits](../governance/recommendations/managing-ai-credits)** - Published a FinOps-oriented guide for governing AI credit consumption across GitHub Enterprise, covering layered budgets design, cost attribution, usage guidance, and an operating cadence
 - **Deprecated: Managing GitHub Copilot Premium Request Units (PRUs)** - Retired the PRU enterprise admin playbook, replaced by the managing AI credits guidance
-- **New Content: [Governing agentic workflows with gh-aw and APM](/library/governance/recommendations/governing-agentic-workflows/)** - Published guidance for enterprises adopting sandboxed AI agents, GitHub Agentic Workflows (gh-aw), and Agent Package Manager (APM) to enforce execution isolation, dependency governance, and auditable agent runs in regulated environments
-- **Update: [Defending against dependency supply chain attacks](/library/application-security/recommendations/managing-dependency-threats/)** - Expanded trusted publishing registry coverage to include NuGet and Crates alongside npm, PyPI, and RubyGems
+- **New Content: [Governing agentic workflows with gh-aw and APM](../governance/recommendations/governing-agentic-workflows)** - Published guidance for enterprises adopting sandboxed AI agents, GitHub Agentic Workflows (gh-aw), and Agent Package Manager (APM) to enforce execution isolation, dependency governance, and auditable agent runs in regulated environments
+- **Update: [Defending against dependency supply chain attacks](../application-security/recommendations/managing-dependency-threats)** - Expanded trusted publishing registry coverage to include NuGet and Crates alongside npm, PyPI, and RubyGems

content/library/productivity/recommendations/adopting-copilot-at-scale.md

@@ -22,19 +22,19 @@ areas:
 # Classifications of industries who may be at different stages of the customer journey.
 verticals:
   - automotive
-  - manufacturing
+  - education
+  - energy
   - finance
   - gaming
-  - media
   - government
-  - information-technology
   - healthcare
+  - hospitality
+  - information-technology
+  - manufacturing
+  - media
+  - professional-service
   - retail
-  - education
-  - energy
   - telecommunications
-  - hospitality
-  - professional-services
 
 # Individuals in key roles on the customer journey, typically consisting of one or more administrators and the end-user community.
 personas:
@@ -111,7 +111,7 @@ An example GitHub Copilot launch plan should include the following minimum eleme
 #### Launch week (week 0)
 
 - Communicate the opportunity, benefits, and availability of GitHub Copilot to your organization
-- Provide on-demand [training](https://learn.microsoft.com/en-us/training/modules/introduction-to-github-copilot/) and [resources](https://docs.github.com/en/enterprise-cloud@latest/copilot/quickstart) for users to get started with GitHub Copilot
+- Provide on-demand [training](https://learn.microsoft.com/en-us/training/modules/introduction-to-github-copilot/) and [resources](https://docs.github.com/en/enterprise-cloud@latest/copilot/get-started/quickstart) for users to get started with GitHub Copilot
 
 #### Post-launch (weeks 1-4)
 
@@ -122,7 +122,7 @@ An example GitHub Copilot launch plan should include the following minimum eleme
 #### Post-launch (weeks 5-8)
 
 - Monitor GitHub Copilot adoption and activity metrics
-- Develop a GitHub Copilot reporting mechanism to track KPIs and derive meaningful insights about GitHub Copilot by using the [Copilot Usage API](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-usage?apiVersion=2022-11-28) and [Copilot User Management API](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-user-management?apiVersion=2022-11-28)
+- Develop a GitHub Copilot reporting mechanism to track KPIs and derive meaningful insights about GitHub Copilot by using the [Copilot usage metrics API](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics?apiVersion=2022-11-28) and [Copilot User Management API](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-user-management?apiVersion=2022-11-28)
 - Build on your GitHub Copilot Expert Hub with advanced training and resources specific to your organization
 - Gather feedback from users and iterate on your GitHub Copilot program
 
@@ -146,7 +146,7 @@ GitHub offers many free resources to help users get started with GitHub Copilot:
 - [GitHub Copilot Learning Pathway](https://resources.github.com/learn/pathways/copilot/essentials/essentials-of-github-copilot/)
 - [GitHub Copilot Youtube Playlist](https://www.youtube.com/playlist?list=PL0lo9MOBetEHEHi9h0k_lPn0XZdEeYZDS)
 - [GitHub Copilot Blog Posts](https://github.blog/?s=copilot)
-- [GitHub Copilot Quickstart Documentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/quickstart)
+- [GitHub Copilot Quickstart Documentation](https://docs.github.com/en/enterprise-cloud@latest/copilot/get-started/quickstart)
 
 To best prepare your existing team and future hires, consider offering a mix of instructor-led and on-demand Copilot enablement resources.
 
@@ -184,10 +184,10 @@ GitHub Copilot licenses can be assigned in a few different ways, each with their
 3) Specific teams in an organization
 4) Specific teams in an enterprise
 
-While assigning licenses out of a single organization can simplify license management, it restricts the granularity of Copilot telemetry data from the [Copilot Usage API endpoint for organizations](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-usage?apiVersion=2022-11-28#get-a-summary-of-copilot-usage-for-organization-members).
+While assigning licenses out of a single organization can simplify license management, it restricts the granularity of Copilot telemetry data from the [Copilot usage metrics API](https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics?apiVersion=2022-11-28#get-copilot-organization-usage-metrics).
 If you would like to track GitHub Copilot usage across your GitHub Organizations, consider assigning licenses to specific teams or individuals in those organizations.
 
-<!-- PLACEHOLDER FOR COPILOT USAGE API ENDPOINT FOR TEAMS TRADE-OFFS -->
+<!-- PLACEHOLDER FOR COPILOT USAGE METRICS API ENDPOINT FOR TEAMS TRADE-OFFS -->
 
 {{< callout type="info" >}}
 When a user receives a seat from multiple organizations in the same enterprise, GitHub takes care of deduplicating these seats before billing for the user.

docs/taxonomies.md

@@ -81,16 +81,21 @@ areas:
 # Classifications of industries who may be at different stages of the customer journey.
 verticals:
   - automotive
+  - education
+  - energy
   - finance
   - gaming
   - government
+  - healthcare
+  - hospitality
   - information-technology
   - manufacturing
   - media
+  - mid-market
   - professional-service
   - retail
   - smb-corporate
-  - mid-market
+  - telecommunications
 
 # Individuals in key roles on the customer journey, typically consisting of one or more administrators and the end-user community.
 personas: