Repo sync

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Docs changelog
 
+**19 May 2026**
+
+We published the first iteration of a [journey landing page](https://docs.github.com/en/enterprise-cloud@latest/copilot/get-started/enterprise-ai-governance) for enterprises adopting and governing GitHub Copilot. The journey covers sign-off and adoption, governance of core features, and agent adoption. It includes six newly published guides alongside some refreshed existing content.
+
+<hr>
+
 **12 May 2026**
 
 We have now published the GitHub Enterprise Server (GHES) 3.21 release candidate notes. You can read the full notes here:

content/billing/how-tos/set-up-payment/connect-azure-sub.md

@@ -30,7 +30,7 @@ You can pay for metered usage of {% data variables.product.github %} features th
 
 * You must know your Azure subscription ID. See [Get subscription and tenant IDs in the Azure portal](https://learn.microsoft.com/en-us/azure/azure-portal/get-subscription-tenant-id) in the Microsoft Docs.
 
-* You must be logged into Azure as a user who is able to provide tenant-wide admin consent or arrange to work with an Azure AD global administrator to configure an admin consent workflow. See [AUTOTITLE](/billing/concepts/azure-subscriptions).
+* You must be logged into Azure as a user who is able to provide tenant-wide admin consent or arrange to work with a Microsoft Entra Global Administrator to configure an admin consent workflow. See [AUTOTITLE](/billing/concepts/azure-subscriptions).
 
 ## Connecting your Azure subscription to an organization or enterprise account
 

content/copilot/get-started/enterprise-ai-governance.md

@@ -0,0 +1,39 @@
+---
+title: Adopting GitHub Copilot in your enterprise
+shortTitle: Enterprise AI governance
+intro: Adopt the latest {% data variables.product.prodname_copilot %} features without compromising on control and governance.
+versions:
+  feature: copilot
+contentType: get-started
+layout: journey-landing
+sidebarLink:
+  text: AI governance journey
+  href: /copilot/get-started/enterprise-ai-governance
+journeyTracks:
+  - id: 'getting_started'
+    title: 'Getting started'
+    description: 'Get approval from internal teams, choose a plan, and enable {% data variables.product.prodname_copilot_short %} for your enterprise.'
+    guides:
+      - href: '/copilot/tutorials/roll-out-at-scale/govern-at-scale/resources-for-approval'
+      - href: '/copilot/tutorials/roll-out-at-scale/assign-licenses/choose-enterprise-plan'
+      - href: '/copilot/how-tos/copilot-on-github/set-up-copilot/enable-copilot/set-up-for-enterprise'
+  - id: 'governance_basics'
+    title: 'Governance basics'
+    description: 'Use {% data variables.product.github %}''s governance features to stay in control of your codebase and compliance requirements.'
+    guides:
+      - href: '/copilot/tutorials/roll-out-at-scale/govern-at-scale/govern-for-adoption'
+      - href: '/copilot/tutorials/roll-out-at-scale/govern-at-scale/maintain-codebase-standards'
+      - href: '/copilot/how-tos/administer-copilot/manage-for-enterprise/review-audit-logs'
+      - href: '/copilot/concepts/preparing-for-new-features-and-models'
+  - id: 'adopting_agents'
+    title: 'Adopting agents'
+    description: 'Roll out agentic features within secure guardrails.'
+    guides:
+      - href: '/copilot/concepts/agents/enterprise-management'
+      - href: '/copilot/tutorials/cloud-agent/build-guardrails'
+      - href: '/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/enable-copilot-cloud-agent'
+      - href: '/copilot/tutorials/cloud-agent/give-access-to-resources'
+      - href: '/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise'
+      - href: '/copilot/tutorials/copilot-cli-hooks'
+      - href: '/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity'
+---

content/copilot/get-started/index.md

@@ -10,9 +10,7 @@ children:
   - /plans
   - /features
   - /best-practices
-  - /choose-enterprise-plan
-  - /achieve-company-goals
-  - /resources-for-approval
+  - /enterprise-ai-governance
 redirect_from:
   - /copilot/about-github-copilot
 contentType: get-started

content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md

@@ -14,6 +14,8 @@ docsTeamMetrics:
   - copilot-cli
 ---
 
+{% data variables.copilot.copilot_cli_short %} brings agentic capabilities to developers' command line. When {% data variables.copilot.copilot_cli_short %} is enabled, developers can use it to ask {% data variables.product.prodname_copilot_short %} to work on tasks locally or delegate work to {% data variables.copilot.copilot_cloud_agent %}.
+
 ## Enabling or disabling {% data variables.copilot.copilot_cli_short %}
 
 You can control the use of {% data variables.copilot.copilot_cli_short %} by configuring a policy.

content/copilot/get-started/choose-enterprise-plan.md → content/copilot/tutorials/roll-out-at-scale/assign-licenses/choose-enterprise-plan.md

@@ -9,8 +9,9 @@ redirect_from:
   - /copilot/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot
   - /copilot/tutorials/rolling-out-github-copilot-at-scale/planning-your-rollout/choosing-your-enterprises-plan-for-github-copilot
   - /copilot/get-started/choosing-your-enterprises-plan-for-github-copilot
-contentType: get-started
-category: 
+  - /copilot/get-started/choose-enterprise-plan
+contentType: tutorials
+category:
   - Manage Copilot for a team
 ---
 
@@ -62,14 +63,3 @@ If your company is gaining value from agentic workflows, you will likely want to
 To download a usage report to see how many premium requests your developers are using, see [AUTOTITLE](/copilot/how-tos/manage-and-track-spending/monitor-premium-requests#viewing-premium-request-usage). {% data variables.copilot.copilot_business_short %} users who use more than around 800 premium requests a month would save money on a {% data variables.copilot.copilot_enterprise_short %} plan.
 
 For more information on managing spending on premium requests, see [AUTOTITLE](/copilot/how-tos/manage-and-track-spending/manage-request-allowances).
-
-## Getting started
-
-When you've determined whether premium requests and {% data variables.copilot.copilot_enterprise_short %} features will help you achieve your goals, it's time to choose a plan. Contact our Sales team to get started with {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %}.
-
-<a href="https://github.com/enterprise/contact?ref_product=copilot&ref_type=purchase&ref_style=button" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Contact Sales</span></a>
-
-## Further reading
-
-* [AUTOTITLE](/copilot/get-started/achieve-engineering-goals)
-* [AUTOTITLE](/copilot/reference/ai-models/model-comparison)

content/copilot/tutorials/roll-out-at-scale/assign-licenses/index.md

@@ -5,6 +5,7 @@ intro: Learn recommended practices for assigning licenses and managing costs.
 versions:
   feature: copilot
 children:
+  - /choose-enterprise-plan
   - /set-up-self-serve-licenses
   - /track-usage-and-adoption
   - /remind-inactive-users

content/copilot/get-started/achieve-company-goals.md → content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/achieve-company-goals.md

@@ -7,8 +7,9 @@ versions:
 allowTitleToDifferFromFilename: true
 redirect_from:
   - /copilot/get-started/achieve-engineering-goals
-contentType: get-started
-category: 
+  - /copilot/get-started/achieve-company-goals
+contentType: tutorials
+category:
   - Manage Copilot for a team
 ---
 

content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/index.md

@@ -5,6 +5,7 @@ intro: Plan your rollout to achieve engineering goals and measure success.
 versions:
   feature: copilot
 children:
+  - /achieve-company-goals
   - /increase-test-coverage
   - /accelerate-pull-requests
   - /reduce-security-debt

content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md → content/copilot/tutorials/roll-out-at-scale/govern-at-scale/establish-ai-managers.md

@@ -1,6 +1,6 @@
 ---
 title: Establishing AI managers in your enterprise
-intro: 'Reduce your administrative burden and empower your SMEs by creating a team of AI managers.'
+intro: Reduce your administrative burden and empower your SMEs by creating a team of AI managers.
 permissions: Enterprise owners
 versions:
   feature: copilot
@@ -9,6 +9,8 @@ category:
   - Roll Copilot out at scale
   - Manage Copilot for a team
 contentType: tutorials
+redirect_from:
+  - /copilot/tutorials/roll-out-at-scale/establish-ai-managers
 ---
 
 > [!NOTE]

content/copilot/tutorials/roll-out-at-scale/govern-for-adoption.md → content/copilot/tutorials/roll-out-at-scale/govern-at-scale/govern-for-adoption.md

@@ -1,14 +1,16 @@
 ---
 title: Governing Copilot to support developer productivity
 shortTitle: Govern for adoption
-intro: 'Set a governance posture that balances compliance requirements with developer productivity, so your rollout succeeds from day one.'
+intro: Set a governance posture that balances compliance requirements with developer productivity, so your rollout succeeds from day one.
 permissions: Enterprise owners
 versions:
   feature: copilot
 category:
   - Roll Copilot out at scale
 contentType: tutorials
 allowTitleToDifferFromFilename: true
+redirect_from:
+  - /copilot/tutorials/roll-out-at-scale/govern-for-adoption
 ---
 
 Getting the most from {% data variables.product.prodname_copilot %} means finding the right balance between governance and developer access. Too restrictive, and developers can't use the features that make them productive. Too permissive, and you may not meet your compliance requirements.

content/copilot/tutorials/roll-out-at-scale/govern-at-scale/index.md

@@ -0,0 +1,14 @@
+---
+title: Governing GitHub Copilot at scale
+shortTitle: Govern at scale
+intro: Balance developer productivity with security, privacy, and compliance.
+versions:
+  feature: copilot
+children:
+  - /resources-for-approval
+  - /establish-ai-managers
+  - /govern-for-adoption
+  - /maintain-codebase-standards
+contentType: tutorials
+---
+

content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md → content/copilot/tutorials/roll-out-at-scale/govern-at-scale/maintain-codebase-standards.md

@@ -1,6 +1,6 @@
 ---
 title: Maintaining codebase standards in a GitHub Copilot rollout
-intro: 'Stay in control of your enterprise''s code with rulesets, security features, and effective training.'
+intro: Stay in control of your enterprise's code with rulesets, security features, and effective training.
 permissions: Enterprise owners
 versions:
   feature: copilot
@@ -9,6 +9,8 @@ category:
   - Roll Copilot out at scale
   - Manage Copilot for a team
 contentType: tutorials
+redirect_from:
+  - /copilot/tutorials/roll-out-at-scale/maintain-codebase-standards
 ---
 
 Most enterprises are aware of the productivity benefits that AI coding tools can bring. However, many worry that improper usage in their company, such as malicious prompts or developers accepting AI suggestions without review, will lead to their codebase's standards being compromised.

content/copilot/get-started/resources-for-approval.md → content/copilot/tutorials/roll-out-at-scale/govern-at-scale/resources-for-approval.md

@@ -1,12 +1,14 @@
 ---
 title: Resources for getting approval of GitHub Copilot
 shortTitle: Resources for approval
-intro: 'Get ready to adopt {% data variables.product.prodname_copilot_short %} by sending resources to legal and security teams in your company.'
+intro: Get ready to adopt {% data variables.product.prodname_copilot_short %} by sending resources to legal and security teams in your company.
 versions:
   feature: copilot
-contentType: get-started
+contentType: tutorials
 category:
   - Manage Copilot for a team
+redirect_from:
+  - /copilot/get-started/resources-for-approval
 ---
 
 Before you can roll out a tool like {% data variables.product.prodname_copilot %} in your company, you will likely need signoff from legal, compliance, and cybersecurity teams.

content/copilot/tutorials/roll-out-at-scale/index.md

@@ -6,15 +6,14 @@ versions:
   feature: copilot
 children:
   - /assign-licenses
-  - /establish-ai-managers
-  - /govern-for-adoption
+  - /govern-at-scale
   - /enable-developers
   - /drive-downstream-impact
   - /measure-success
-  - /maintain-codebase-standards
 redirect_from:
   - /copilot/rolling-out-github-copilot-at-scale
   - /copilot/tutorials/rolling-out-github-copilot-at-scale/planning-your-rollout
   - /copilot/tutorials/rolling-out-github-copilot-at-scale
 contentType: tutorials
 ---
+

data/reusables/webhooks/watch_properties.md

@@ -1,3 +1,3 @@
 Key | Type | Description
 ----|------|-------------
-`action`|`string` | The action that was performed. Currently, can only be `started`.
+`action`|`string` | Can only be `started` to indicate a user starred a repository.

data/reusables/webhooks/watch_short_desc.md

@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see [AUTOTITLE](/rest/activity#starring).
+A user stars a repository (historically referred to as "watching"). {% data reusables.webhooks.action_type_desc %} For more information, see [AUTOTITLE](/rest/activity#starring).