diff --git a/CHANGELOG.md b/CHANGELOG.md index 5e6ee19b501f..2864ca1dec75 100644 --- a/CHANGELOG.md +++ b/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. + +
+ **12 May 2026** We have now published the GitHub Enterprise Server (GHES) 3.21 release candidate notes. You can read the full notes here: diff --git a/content/billing/how-tos/set-up-payment/connect-azure-sub.md b/content/billing/how-tos/set-up-payment/connect-azure-sub.md index 9f4a282ddb02..8ad8db19b748 100644 --- a/content/billing/how-tos/set-up-payment/connect-azure-sub.md +++ b/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 diff --git a/content/copilot/get-started/enterprise-ai-governance.md b/content/copilot/get-started/enterprise-ai-governance.md new file mode 100644 index 000000000000..a01c4f02c6ab --- /dev/null +++ b/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' +--- diff --git a/content/copilot/get-started/index.md b/content/copilot/get-started/index.md index 540cc5031709..48bb7fc55da9 100644 --- a/content/copilot/get-started/index.md +++ b/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 diff --git a/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md b/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md index 6dc4ee6be073..f97f0a5be09e 100644 --- a/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md +++ b/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. diff --git a/content/copilot/get-started/choose-enterprise-plan.md b/content/copilot/tutorials/roll-out-at-scale/assign-licenses/choose-enterprise-plan.md similarity index 90% rename from content/copilot/get-started/choose-enterprise-plan.md rename to content/copilot/tutorials/roll-out-at-scale/assign-licenses/choose-enterprise-plan.md index 2db1907fc4fe..578484036640 100644 --- a/content/copilot/get-started/choose-enterprise-plan.md +++ b/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 %}. - -Contact Sales - -## Further reading - -* [AUTOTITLE](/copilot/get-started/achieve-engineering-goals) -* [AUTOTITLE](/copilot/reference/ai-models/model-comparison) diff --git a/content/copilot/tutorials/roll-out-at-scale/assign-licenses/index.md b/content/copilot/tutorials/roll-out-at-scale/assign-licenses/index.md index 9cfc9dd41339..c6e6ffd72ca6 100644 --- a/content/copilot/tutorials/roll-out-at-scale/assign-licenses/index.md +++ b/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 diff --git a/content/copilot/get-started/achieve-company-goals.md b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/achieve-company-goals.md similarity index 96% rename from content/copilot/get-started/achieve-company-goals.md rename to content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/achieve-company-goals.md index f74bc2b50a2a..545fd020aa06 100644 --- a/content/copilot/get-started/achieve-company-goals.md +++ b/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 --- diff --git a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/index.md b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/index.md index 6c64b4ee1973..5c23555182fb 100644 --- a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/index.md +++ b/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 diff --git a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/establish-ai-managers.md similarity index 96% rename from content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md rename to content/copilot/tutorials/roll-out-at-scale/govern-at-scale/establish-ai-managers.md index aa39d2b751b9..4a18991df098 100644 --- a/content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md +++ b/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] diff --git a/content/copilot/tutorials/roll-out-at-scale/govern-for-adoption.md b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/govern-for-adoption.md similarity index 94% rename from content/copilot/tutorials/roll-out-at-scale/govern-for-adoption.md rename to content/copilot/tutorials/roll-out-at-scale/govern-at-scale/govern-for-adoption.md index 1d3869666951..860c467e535a 100644 --- a/content/copilot/tutorials/roll-out-at-scale/govern-for-adoption.md +++ b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/govern-for-adoption.md @@ -1,7 +1,7 @@ --- 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 @@ -9,6 +9,8 @@ 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. diff --git a/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/index.md b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/index.md new file mode 100644 index 000000000000..291ea985af69 --- /dev/null +++ b/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 +--- + diff --git a/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/maintain-codebase-standards.md similarity index 97% rename from content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md rename to content/copilot/tutorials/roll-out-at-scale/govern-at-scale/maintain-codebase-standards.md index f309b56f9c18..d1659673632d 100644 --- a/content/copilot/tutorials/roll-out-at-scale/maintain-codebase-standards.md +++ b/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. diff --git a/content/copilot/get-started/resources-for-approval.md b/content/copilot/tutorials/roll-out-at-scale/govern-at-scale/resources-for-approval.md similarity index 96% rename from content/copilot/get-started/resources-for-approval.md rename to content/copilot/tutorials/roll-out-at-scale/govern-at-scale/resources-for-approval.md index bcc7be7c3872..c641280bd49f 100644 --- a/content/copilot/get-started/resources-for-approval.md +++ b/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. diff --git a/content/copilot/tutorials/roll-out-at-scale/index.md b/content/copilot/tutorials/roll-out-at-scale/index.md index f8e4e2b5588a..555aaa57f4c2 100644 --- a/content/copilot/tutorials/roll-out-at-scale/index.md +++ b/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 --- + diff --git a/data/reusables/webhooks/watch_properties.md b/data/reusables/webhooks/watch_properties.md index 964267358e91..e0d1019c952e 100644 --- a/data/reusables/webhooks/watch_properties.md +++ b/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. diff --git a/data/reusables/webhooks/watch_short_desc.md b/data/reusables/webhooks/watch_short_desc.md index c833bc57eb0c..6267df39d687 100644 --- a/data/reusables/webhooks/watch_short_desc.md +++ b/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).