Driver content: new articles for choosing your Copilot plan and managing spending (#54836)

Co-authored-by: Felicity Chapman <felicitymay@github.com>

content/billing/using-the-new-billing-platform/preventing-overspending.md

@@ -18,10 +18,11 @@ Budgets and alerts allow you to track spending for your {% ifversion fpt %}organ
 
 The budget only applies to expenses incurred from the date of its creation onwards. Any expenses incurred prior to the creation of the budget will not be included in the calculations
 
-Budgets are not applicable to:
+{% ifversion ghec %}
+Budgets are not applicable to pre-paid volume licenses.
+{% endif %}
 
-* {% ifversion enterprise-licensing-language %}License{% else %}Seat{% endif %}-based products such as {% data variables.product.prodname_copilot %}{% ifversion fpt %} and {% data variables.product.prodname_team %}{% elsif ghec %}, {% data variables.product.prodname_GH_advanced_security %}, and {% data variables.product.prodname_enterprise %}.
-* Pre-paid volume licenses{% endif %}.
+For license-based products such as {% data variables.product.prodname_copilot %}{% ifversion fpt %} and {% data variables.product.prodname_team %}{% elsif ghec %}, {% data variables.product.prodname_GH_advanced_security %}, and {% data variables.product.prodname_enterprise %}{% endif %}, setting a budget does not prevent usage over the limit.
 
 > [!NOTE]
 > By default, paid usage will be limited to $0 for accounts that do not have a payment method on file. For accounts that do have a payment method on file, the default budget is unlimited.

content/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot.md

@@ -3,7 +3,7 @@ title: Creating a custom model for GitHub Copilot
 shortTitle: Create a custom model
 intro: "You can fine-tune {% data variables.product.prodname_copilot_short %} code completion by creating a custom model based on code in your organization's repositories."
 permissions: "Owners of organizations enrolled in the {% data variables.release-phases.public_preview %}."
-product: "The organization must belong to an enterprise with a {% data variables.product.prodname_copilot_enterprise_short %} subscription."
+product: '{% data reusables.copilot.ce-product-callout %}'
 versions:
   feature: copilot-custom-models
 topics:

content/copilot/customizing-copilot/managing-copilot-knowledge-bases.md

@@ -4,6 +4,7 @@ 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:
   ghec: '*'
+product: '{% data reusables.copilot.ce-product-callout %}'
 topics:
   - Copilot
 redirect_from:

content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise.md

@@ -11,22 +11,15 @@ topics:
   - Copilot
 ---
 
-## About pricing for {% data variables.product.prodname_copilot_short %} in your enterprise
+## About {% data variables.product.prodname_copilot_short %} plans for your enterprise
 
-Enterprises on {% data variables.product.prodname_ghe_cloud %} can subscribe to either {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}. For more information, see [AUTOTITLE](/copilot/about-github-copilot/subscription-plans-for-github-copilot).
+{% data variables.product.company_short %} offers the following plans for enterprise accounts:
+* **{% data variables.product.prodname_copilot_business_short %}** at {% data variables.copilot.cfb_price_per_month %} per user per month
+* **{% data variables.product.prodname_copilot_enterprise_short %}** at {% data variables.copilot.ce_price_per_month %} per user per month
 
-### Pricing for {% data variables.product.prodname_copilot_for_business %}
+When you subscribe to {% data variables.product.prodname_copilot_enterprise_short %} at the enterprise level, you can choose which plan to enable for each organization in your enterprise.
 
-Subscriptions to {% data variables.product.prodname_copilot_business_short %} are available on a monthly cycle. The subscriptions are billed to the enterprise account at the end of each cycle, at {% data variables.copilot.cfb_price_per_month %} per user per month.
-
-### Pricing for {% data variables.product.prodname_copilot_enterprise %}
-
-With a {% data variables.product.prodname_copilot_enterprise %} subscription, you can choose to assign either {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} to each individual organization in the enterprise.
-
-Subscriptions to {% data variables.product.prodname_copilot_enterprise_short %} are available on a monthly cycle. The subscriptions are billed to the enterprise account at the end of each cycle, at the following prices:
-
-* For organizations in the enterprise that are assigned a **{% data variables.product.prodname_copilot_for_business %}** subscription: {% data variables.copilot.cfb_price_per_month %} per user per month.
-* For organizations in the enterprise that are assigned a **{% data variables.product.prodname_copilot_enterprise %}** subscription: {% data variables.copilot.ce_price_per_month %} per user per month.
+For guidance, see [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/choosing-your-enterprises-plan-for-github-copilot).
 
 ## About the billing cycle for {% data variables.product.prodname_copilot_short %} in your enterprise
 

content/copilot/rolling-out-github-copilot-at-scale/choosing-your-enterprises-plan-for-github-copilot.md

@@ -0,0 +1,54 @@
+---
+title: Choosing your enterprise's plan for GitHub Copilot
+shortTitle: Choose your plan
+intro: 'Choose between {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %}.'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+permissions: 'Enterprise owners and billing managers'
+---
+
+When you adopt {% data variables.product.prodname_copilot %} in a company, you will sign up to a {% data variables.product.prodname_copilot_short %} plan designed for businesses. These plans allow you to:
+
+* Choose which users receive access to {% data variables.product.prodname_copilot_short %}
+* Meet regulations and security requirements with features like file exclusion, policies, and audit logs
+* Benefit from advanced {% data variables.product.prodname_copilot_short %} features
+
+{% data variables.product.prodname_copilot_enterprise_short %} offers additional features for enterprises that want to customize {% data variables.product.prodname_copilot_short %} for their needs.
+
+<a href="https://github.com/github-copilot/purchase" 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>
+
+## About the plans
+
+{% data variables.product.company_short %} offers two {% data variables.product.prodname_copilot_short %} plans for customers on {% data variables.product.prodname_ghe_cloud %}:
+
+* **{% data variables.product.prodname_copilot_business_short %}** ({% data variables.copilot.cfb_price_per_month %} per user per month): includes most {% data variables.product.prodname_copilot_short %} features in IDEs and on the {% data variables.product.github %} website.
+* **{% data variables.product.prodname_copilot_enterprise_short %}** ({% data variables.copilot.ce_price_per_month %} per user per month): allows companies to customize {% data variables.product.prodname_copilot_short %} for their code and processes. To learn more, see [Customization with {% data variables.product.prodname_copilot_enterprise_short %}](#customization-with-copilot-enterprise).
+
+For a full comparison, see our [plans page](https://github.com/features/copilot/plans).
+
+## Customization with {% data variables.product.prodname_copilot_enterprise_short %}
+
+Many companies have complex repositories, such as large monorepos or legacy codebases, that can be difficult to get started with. Developers may need to spend a long time finding and reading documentation before they can contribute.
+
+With {% data variables.product.prodname_copilot_enterprise_short %}, you can create **knowledge bases** that bring together documentation from one or more repositories in an organization. Users can specify the knowledge base as the context for {% data variables.product.prodname_copilot_chat_short %}, allowing {% data variables.product.prodname_copilot_short %} to synthesize information from your documentation in its response.
+
+## About mixed plans
+
+When you subscribe your enterprise account to {% data variables.product.prodname_copilot_enterprise_short %}, you don't need to use this plan across the whole enterprise. Instead, you can choose a plan individually for each organization in your enterprise. This approach allows you to:
+
+* Evaluate the benefits of {% data variables.product.prodname_copilot_enterprise_short %} for a smaller group of users before rolling it out further.
+* Enable {% data variables.product.prodname_copilot_enterprise_short %} in the organizations where it will have the most impact, such as organizations with complex documentation or legacy codebases.
+
+## Making a decision
+
+To summarize:
+
+* Choose {% data variables.product.prodname_copilot_enterprise_short %} if your company has projects with complex requirements or large amounts of documentation. Knowledge bases give {% data variables.product.prodname_copilot_short %} enhanced context, which can save developers time and allow them to focus on tasks they enjoy.
+* If you're not sure about a full rollout, choose {% data variables.product.prodname_copilot_enterprise_short %} at the enterprise level and enable it for individual organizations where it will have the most impact.
+
+## Further reading
+
+* [AUTOTITLE](/enterprise-cloud@latest/copilot/customizing-copilot/managing-copilot-knowledge-bases)
+* [AUTOTITLE](/enterprise-cloud@latest/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot)

content/copilot/rolling-out-github-copilot-at-scale/index.md

@@ -7,8 +7,10 @@ versions:
 topics:
   - Copilot
 children:
+  - /choosing-your-enterprises-plan-for-github-copilot
   - /driving-copilot-adoption-in-your-company
   - /setting-up-a-self-serve-process-for-github-copilot-licenses
   - /analyzing-usage-over-time-with-the-copilot-metrics-api
   - /reminding-inactive-users
+  - /managing-your-companys-spending-on-github-copilot
 ---

content/copilot/rolling-out-github-copilot-at-scale/managing-your-companys-spending-on-github-copilot.md

@@ -0,0 +1,74 @@
+---
+title: Managing your company's spending on GitHub Copilot
+shortTitle: Manage spending
+intro: 'Learn how to track spending, view usage, and optimize license distribution.'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+permissions: 'Enterprise owners and billing managers'
+product: '{% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}'
+---
+
+When you're adopting {% data variables.product.prodname_copilot %} in an enterprise, you will want to set budgets and track spending to ensure your rollout is sustainable. {% data variables.product.github %} offers billing tools to help you visualize your spending patterns, receive alerts when you reach budget thresholds, and optimize your license usage.
+
+>[!NOTE] Some of the tools recommended in this article are part of {% data variables.product.github %}'s new billing platform, which isn't available to all customers. If your enterprise has access, you will see a **{% octicon "credit-card" aria-hidden="true" %} Billing & Licensing** option in your enterprise account's settings.
+
+## Understand who can grant licenses
+
+To control spending, it's important to understand who can affect your bill by granting licenses to users. These are people with the **organization owner** role in organizations where you enable {% data variables.product.prodname_copilot %}. Organization owners can receive requests for access from members through the {% data variables.product.github %} UI.
+
+We recommend that you identify the people with this role and communicate with them about your company's strategy for distributing licenses. For example, you may have a budget or limited pilot program, or you may distribute licenses through an internal website.
+
+## Map spending to groups of users
+
+With {% data variables.product.github %}'s new billing platform, you can create cost centers to map spending to individual business units or groups of users. Cost centers allow you to track costs tied to different initiatives and charge the costs to specific areas of your business.
+
+For example, if you were running a pilot program for {% data variables.product.prodname_copilot_enterprise %} for a group of employees, you might want to create a cost center to track their spending and set a budget independently of the rest of the company.
+
+### Create a cost center
+
+1. Go to your enterprise account settings and click **{% octicon "credit-card" aria-hidden="true" %} Billing & Licensing**.
+1. In the left sidebar, click **Cost centers**, then click **New cost center**.
+1. Create the cost center. You don't need to add any repositories or organizations, because you will add users to the cost center directly in the next step.
+
+   >[!NOTE] As a priority, a cost center is charged for a {% data variables.product.prodname_copilot_short %} license if the assigned **user** has been added to the cost center directly. As a fallback, a cost center is charged for the license if the **organization where the user receives access** has been added to the cost center.
+
+1. After creating the cost center, use the REST API to add the users whose usage you want to track. See [AUTOTITLE](/enterprise-cloud@latest/rest/enterprise-admin/billing#add-users-to-a-cost-center).
+
+## Receive alerts for overspending
+
+With {% data variables.product.github %}'s new billing platform, you can ensure your spending on {% data variables.product.prodname_copilot %} is manageable by setting a monthly budget. A budget for {% data variables.product.prodname_copilot_short %} won't limit usage, but you will receive notifications by email when spending exceeds certain percentages of the budget you've set.
+
+You can create the budget for the whole enterprise or for a cost center.
+
+1. Go to your enterprise account settings and click **{% octicon "credit-card" aria-hidden="true" %} Billing & Licensing**.
+1. In the left sidebar, click **Budgets and alerts**.
+1. Click **New budget**.
+1. Select **{% data variables.product.prodname_copilot_short %}** as the product, then configure the settings as required. You can choose who receives alerts when budget thresholds are reached.
+1. Click **Create budget**.
+
+## Visualize spending trends
+
+With {% data variables.product.github %}'s new billing platform, you can understand your spending trends by viewing a graph for {% data variables.product.prodname_copilot_short %} usage over a certain timeframe. For more detailed insights, you can filter the results by cost center and group usage by the type of {% data variables.product.prodname_copilot_short %} plan.
+
+1. Go to your enterprise account settings and click **{% octicon "credit-card" aria-hidden="true" %} Billing & Licensing**.
+1. In the left sidebar, click **Usage**.
+1. In the "Metered usage" section, in the search field, enter `product:copilot`. To filter by cost center, add a query like `cost_center:ce-pilot-group`.
+1. To understand spending differences between {% data variables.product.prodname_copilot_business_short %} and {% data variables.product.prodname_copilot_enterprise_short %} plans, select the **Group: None** dropdown menu and click **Group: SKU**.
+
+![Screenshot of the "Usage" page. A line chart tracks Copilot spending over the current month, grouped by SKU.](/assets/images/help/copilot/track-spending.png)
+
+## Optimize license usage
+
+When you begin rolling out {% data variables.product.prodname_copilot_short %} in a company, you may see low rates of adoption at first. An effective enablement process is essential to drive adoption of {% data variables.product.prodname_copilot_short %} in your company. Tailor this process to your company's needs and goals, and design it to help your teams understand how to use {% data variables.product.prodname_copilot_short %} effectively.
+
+To ensure your licenses are being used effectively, you can use the API to identify inactive users. We recommend sending these users a message with advice and resources for getting started. If a user remains inactive, you can revoke their license and assign it to another user.
+
+If you're not sure how best to distribute licenses, {% data variables.product.company_short %} has found that many successful rollouts offer a fully self-service model where developers can claim a license without approval. This allows people to get started quickly and ensures you're giving licenses to people who plan to use them.
+
+For detailed guidance, see:
+
+* [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company)
+* [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/setting-up-a-self-serve-process-for-github-copilot-licenses)
+* [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/reminding-inactive-users)

data/reusables/copilot/ce-product-callout.md

@@ -0,0 +1 @@
+Organizations with a **{% data variables.product.prodname_copilot_enterprise_short %}** subscription.