[EDI billing] Create conceptual article about budgets (#57108)

Author: isaacmbrown

content/billing/concepts/budgets-and-alerts.md

@@ -0,0 +1,39 @@
+---
+title: Budgets and alerts
+intro: 'Budgets help you track and control spending on different products.'
+shortTitle: Budgets and alerts
+versions:
+  feature: enhanced-billing-platform
+topics:
+  - Billing
+  - Enterprise
+  - Team
+contentType: concepts
+---
+
+Budgets and alerts allow you to track spending on metered products for your enterprise, organizations, cost centers (enterprise only), and repositories. Budgets and alerts are not available for pre-paid volume licenses.
+
+By setting a monthly budget, you can monitor your spending and receive notifications by email when your spending exceeds certain preset percentages of your budget threshold. This can help you stay within your budget and avoid overspending.
+
+Many accounts already have default budgets for certain products. {% data reusables.billing.migrated-budgets %}
+
+## Stopping usage
+
+For license-based products such as {% data variables.product.prodname_copilot %}, {% data variables.product.prodname_AS %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_enterprise %}, setting a budget does not prevent usage over the budget amount but does provide alerts.
+
+For metered products such as {% data variables.product.prodname_actions %} or {% data variables.product.prodname_copilot %} premium requests, you can choose for budgets to prevent usage once the budget amount is reached.
+
+## Types and scopes
+
+Each budget has a type and a scope that define which paid use contributes to spending against the budget.
+
+* **Type**: Defines which metered product or SKU is measured.
+* **Scope**: Defines whether the budget applies to the whole account, or to a subset of repositories, organizations, or cost centers (enterprise only).
+
+## Your first billing cycle after creating a budget
+
+When you first create a budget, be aware that the budget applies only to metered usage from the date of its creation onwards. Any use made before you created the budget is not included in the calculations. This means that you may exceed your budget in the first billing cycle after you create your budget, even if you select the option stop usage when the limit is reached.
+
+## Set up a budget
+
+To get started with budgets, see [AUTOTITLE](/billing/tutorials/set-up-budgets).

content/billing/concepts/index.md

@@ -10,6 +10,7 @@ topics:
   - Billing
 children:
   - /billing-cycles
+  - /budgets-and-alerts
   - /azure-subscriptions
   - /impact-of-plan-changes
   - /discounted-plans

content/billing/get-started/how-billing-works.md

@@ -31,7 +31,7 @@ topics:
 contentType: get-started
 ---
 
-<!-- 
+<!--
 Audience: All users
 JTBD: When I decide I want to pay for increased access, I need to understand what and how GitHub will charge me, so that I feel confident that I have been billed correctly and don't get any surprises. -->
 
@@ -41,7 +41,7 @@ You can use {% data variables.product.github %} without incurring any costs. If
 
 * **{% data variables.product.github %} plans**: A fixed monthly cost for a paid {% data variables.product.github %} account (for example: {% data variables.product.prodname_pro %} or {% data variables.product.prodname_team %}) or {% data variables.product.prodname_copilot_short %} plan.
 * **Subscriptions**: Fixed monthly costs for any additional products you subscribe to (for example: {% data variables.product.prodname_GH_secret_protection %})
-* **Metered usage**: Variable costs that depend on how much you use certain features above the amounts included with your {% data variables.product.github %} plan (for example: {% data variables.product.prodname_actions %}). For more information see, [AUTOTITLE](/billing/reference/product-usage-included) and [AUTOTITLE](/billing/tutorials/set-up-budgets).
+* **Metered usage**: Variable costs that depend on how much you use certain features above the amounts included with your {% data variables.product.github %} plan (for example: {% data variables.product.prodname_actions %}). For more information see, [AUTOTITLE](/billing/reference/product-usage-included) and [AUTOTITLE](/billing/concepts/budgets-and-alerts).
 
 > [!TIP]
 > {% data variables.product.github %} has discounted plans for verified students and academic faculties, and for non-profit organizations. For more information, see [AUTOTITLE](/billing/managing-the-plan-for-your-github-account/discounted-plans-for-github-accounts).

content/billing/tutorials/set-up-budgets.md

@@ -30,29 +30,7 @@ shortTitle: Set up budgets
 contentType: tutorials
 ---
 
-Budgets and alerts allow you to track spending on metered products for your accounts, organizations, cost centers (enterprise only), and repositories. By setting a monthly budget, you can monitor your spending and receive notifications by email when your spending exceeds certain preset percentages of your budget threshold. This can help you stay within your budget and avoid overspending.
-
-If your account does not have a valid payment method on file, usage is blocked once you use up your quota.
-
-If you have a valid payment method on file, spending may be limited by one or more budgets. Check the budgets set for your account to ensure they are appropriate for your usage needs.
-
-{% data reusables.billing.migrated-budgets %}
-
-## About budgets
-
-Each budget has a type and a scope that define which paid use contributes to spending against the budget.
-
-* **Type**: Defines which metered product or SKU is measured.
-* **Scope**: Defines whether the budget applies to the whole account, or to a subset of repositories, organizations, or cost centers (enterprise only).
-
-### Your first billing cycle after creating a budget
-
-When you first create a budget, be aware that the budget applies only to metered usage from the date of its creation onwards. Any use made before you created the budget, is not included in the calculations. This means that you may exceed your budget in the first billing cycle after you create your budget, even if you select the option stop usage when the limit is reached.
-
-### Budget limitations
-
-For license-based products such as {% data variables.product.prodname_copilot %}, {% data variables.product.prodname_AS %}, {% data variables.product.prodname_team %}, and {% data variables.product.prodname_enterprise %}, setting a budget does not prevent usage over the limit but does provide alerts.
-Budgets and alerts are not available for pre-paid volume licenses.
+Budgets help you track and control spending on different products. To learn more, see [AUTOTITLE](/billing/concepts/budgets-and-alerts).
 
 ## Deciding on the type and scope for a budget
 
@@ -62,7 +40,7 @@ When deciding on the type and scope for a budget, remember that the use of meter
 
 In this example, the organization has set a budget of $50 for the "Actions" product and a budget of $100 for one of the SKUs within the "Actions" product. The organization has used all the included quota of actions minutes and an extra $50 of billed minutes. Some of the extra use was for Linux 96-core runners so it is applied to both budgets. Overall, the organization has used the full budget for the "Actions" product of $50. Members are now blocked from using all {% data variables.product.github %}-hosted runners until the next billing cycle or until the "Actions" product budget is increased. The SKU budget for Linux 96-core runners serves no purpose and is confusing, so should be deleted.
 
-We recommend that you avoid creating overlapping budgets for the use of a product and a SKU, or an organization and a repository, so that users are not unexpectedly blocked from using a feature that they rely on. Alternative, you may prefer to monitor use without blocking users by disabling the "Stop usage when budget limit is reached" option.
+We recommend that you avoid creating overlapping budgets for the use of a product and a SKU, or an organization and a repository, so that users are not unexpectedly blocked from using a feature that they rely on. Alternatively, you may prefer to monitor use without blocking users by disabling the "Stop usage when budget limit is reached" option.
 
 ## Managing budgets for your personal account