Repo sync

content/admin/all-releases.md

@@ -57,6 +57,7 @@ If you run analysis in an external CI system, we recommend using the same versio
 
 | {% data variables.product.prodname_ghe_server %} version | Recommended {% data variables.product.prodname_codeql_cli %} version |
 | ------------------------------------------------- | ---------------------- |
+| 3.21 | 2.24.3 ([changelog](https://codeql.github.com/docs/codeql-overview/codeql-changelog/codeql-cli-2.24.3/)) |
 | 3.20 | 2.23.9 ([changelog](https://codeql.github.com/docs/codeql-overview/codeql-changelog/codeql-cli-2.23.9/)) |
 | 3.19 | 2.22.4 ([changelog](https://codeql.github.com/docs/codeql-overview/codeql-changelog/codeql-cli-2.22.4/)) |
 | 3.18 | 2.21.4 ([changelog](https://codeql.github.com/docs/codeql-overview/codeql-changelog/codeql-cli-2.21.4/)) |
@@ -79,6 +80,7 @@ For instances with {% data variables.product.prodname_actions %} enabled, self-h
 
 | {% data variables.product.prodname_ghe_server %} version | Minimum Runner version |
 | ------------------------------------------------- | ---------------------- |
+| 3.21 | 2.331.0 ([release notes](https://github.com/actions/runner/releases/tag/v2.331.0)) |
 | 3.20 | 2.330.0 ([release notes](https://github.com/actions/runner/releases/tag/v2.330.0)) |
 | 3.19 | 2.328.0 ([release notes](https://github.com/actions/runner/releases/tag/v2.328.0)) |
 | 3.18 | 2.324.0 ([release notes](https://github.com/actions/runner/releases/tag/v2.324.0)) |

content/copilot/concepts/billing/usage-based-billing-for-individuals.md

@@ -47,7 +47,7 @@ Each {% data variables.product.prodname_copilot_short %} individual plan subscri
 
 **Base credits** are included with your plan subscription each month. These match with your subscription price and they never change.
 
-Each plan currently also includes a **flex allotment**. This in an additional monthly amount on top of your base credits. The flex allotment is a variable part of your included usage; it is designed to adapt as the economics of AI evolve, including model pricing, new models, and improvements in efficiency.
+Each plan currently also includes a **flex allotment**. This is an additional monthly amount on top of your base credits. The flex allotment is a variable part of your included usage; it is designed to adapt as the economics of AI evolve, including model pricing, new models, and improvements in efficiency.
 
 Your base credits are used first. If you go beyond your base credits, the flex allotment is applied automatically at the same rates across your IDE, {% data variables.product.prodname_dotcom_the_website %}, and the {% data variables.copilot.copilot_cli_short %}. No additional setup is required. Your usage dashboard shows your available allowance and what you've used.
 

content/copilot/how-tos/manage-and-track-spending/prepare-for-usage-based-billing.md

@@ -1,50 +1,48 @@
----
-title: Preparing your organization for usage-based billing
-shortTitle: Prepare your organization for usage-based billing
-allowTitleToDifferFromFilename: true
-intro: 'Review your estimated costs under usage-based billing and take steps to prepare your organization before the transition.'
-permissions: Enterprise owners, organization owners, and billing managers
-versions:
-  feature: copilot
-product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}'
-contentType: how-tos
-category:
-  - Manage Copilot for a team
----
-
-<!-- expires 2026-06-01 -->
-
-On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. **Starting in early May**, use the tools below to understand how this change affects your organization and prepare before the transition takes effect.
-
-<!-- end expires 2026-06-01 -->
-
-## Preview your bill (coming in early May)
-
-From the announcement banner on your enterprise home page, billing overview page, or premium request analytics page, click **Preview my bill** to see how your current usage translates to {% data variables.product.prodname_ai_credits %}.
-
-The modal shows a side-by-side comparison of your actual spend under the current billing model and your estimated spend under usage-based billing, based on your April 2026 billing period. A difference indicator shows whether your estimated spend is higher, lower, or roughly equal.
-
-Amounts shown are gross totals before discounts, promotional included usage, and contractual adjustments.
-
-## Download the usage report
-
-From the billing preview modal, click **Download CSV** to request a detailed usage report. You can also request the report from the premium request analytics page or via the API. The report is generated asynchronously and delivered via email to the requesting admin.
-
-The report includes one row per user, per model, per day. Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
-
-* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
-* `aic_gross_amount`: The estimated cost in USD under usage-based billing
-
-## Explore the billing preview tool
-
-For a more detailed breakdown, you can upload your CSV to the billing preview tool (coming early May). The tool gives you an interactive view of your estimated costs broken down by model, user, and SKU.
-
-Your data stays in your browser; nothing is uploaded to a server.
-
-## Take action before the transition
-
-Based on what you've learned from the billing preview and usage report, you can take steps to prepare:
-
-* **Review and adjust your budgets**. Existing enterprise-level budgets for premium requests will automatically carry over to {% data variables.product.prodname_ai_credits_short %}. Review them in your enterprise billing settings to make sure they still reflect the limits you want.
-* **Plan for pooled {% data variables.product.prodname_ai_credits_short %}**. Under usage-based billing, each license comes with a monthly amount of included {% data variables.product.prodname_ai_credits_short %}, which are pooled across your organization. Consider how this changes your cost structure. Teams with uneven usage patterns may benefit.
-* **Communicate the change internally**. Let your teams know that billing is changing and what it means for their day-to-day use of {% data variables.product.prodname_copilot_short %}.
+---
+title: Preparing your organization for usage-based billing
+shortTitle: Prepare your organization for usage-based billing
+allowTitleToDifferFromFilename: true
+intro: 'Review your estimated costs under usage-based billing and take steps to prepare your organization before the transition.'
+permissions: Enterprise owners, organization owners, and billing managers
+versions:
+  feature: copilot
+product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}'
+contentType: how-tos
+category:
+  - Manage Copilot for a team
+---
+
+<!-- expires 2026-06-01 -->
+
+On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects your organization and prepare before the transition takes effect.
+
+<!-- end expires 2026-06-01 -->
+
+## Download the usage report
+
+From the announcement banner on your enterprise home page, billing overview page, or premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %}** to request a detailed usage report. You can also request the report from the premium request analytics page or via the API. The report is generated asynchronously and delivered via email to the requesting admin.
+
+The report includes one row per user, per model, per day. Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
+
+* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
+* `aic_gross_amount`: The estimated cost in USD under usage-based billing
+
+## See projected spend
+
+For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
+
+* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
+* A detailed breakdown of licenses, consumed units, included discounts, and additional usage for each billing model.
+
+> [!NOTE]
+> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
+
+Your data stays in your browser; nothing is uploaded to a server.
+
+## Take action before the transition
+
+Based on what you've learned from the billing preview and usage report, you can take steps to prepare:
+
+* **Review and adjust your budgets**. Existing enterprise-level budgets for premium requests will automatically carry over to {% data variables.product.prodname_ai_credits_short %}. Review them in your enterprise billing settings to make sure they still reflect the limits you want.
+* **Plan for pooled {% data variables.product.prodname_ai_credits_short %}**. Under usage-based billing, each license comes with a monthly amount of included {% data variables.product.prodname_ai_credits_short %}, which are pooled across your organization. Consider how this changes your cost structure. Teams with uneven usage patterns may benefit.
+* **Communicate the change internally**. Let your teams know that billing is changing and what it means for their day-to-day use of {% data variables.product.prodname_copilot_short %}.

content/copilot/how-tos/manage-and-track-spending/prepare-for-your-move-to-usage-based-billing.md

@@ -1,51 +1,49 @@
----
-title: Preparing for your move to usage-based billing
-shortTitle: Preparing for usage-based billing
-allowTitleToDifferFromFilename: true
-intro: 'If you''re on a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.'
-versions:
-  feature: copilot
-product: '{% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}'
-contentType: how-tos
-category: 
-  - Configure Copilot
----
-
-<!-- expires 2026-06-01 -->
-
-On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. **Starting in early May**, use the tools below to understand how this change affects you before the transition takes effect.
-
-<!-- end expires 2026-06-01 -->
-
-## Preview your bill (coming in early May)
-
-From the announcement banner on the premium request analytics page, click **Preview my bill** to see how your current usage translates to {% data variables.product.prodname_ai_credits %}.
-
-The modal shows a side-by-side comparison of your actual spend under the current billing model and your estimated spend under usage-based billing, based on your April 2026 billing period. A difference indicator shows whether your estimated spend is higher, lower, or roughly equal.
-
-Amounts shown are gross totals before discounts and contractual adjustments.
-
-## Download the usage report
-
-From the billing preview modal, click **Download CSV** to request a detailed usage report. You can also request the report directly from the premium request analytics page, by clicking **Get usage report**. The report is generated asynchronously and delivered to you via email.
-
-Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
-
-* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
-* `aic_gross_amount`: The estimated cost in USD under usage-based billing
-
-## Explore the billing preview tool
-
-For a more detailed breakdown, you can upload your usage report CSV to the billing preview tool (coming early May). The tool gives you an interactive view of your estimated costs.
-
-Your data stays in your browser; nothing is uploaded to a server.
-
-## Prepare for the transition
-
-* **Understand what consumes credits**. {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_cli_short %}, {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_spaces %}, {% data variables.product.prodname_spark_short %}, and third-party coding agents consume {% data variables.product.prodname_ai_credits_short %}. Code completions and {% data variables.copilot.next_edit_suggestions %} remain unlimited for all paid plans.
-* **Consider your model usage**. Frontier models consume more credits per interaction than lightweight models. Switching to a lighter model for routine tasks can stretch your included usage further.
-
-## Further reading
-
-* [AUTOTITLE](/copilot/concepts/billing/usage-based-billing-for-individuals)
+---
+title: Preparing for your move to usage-based billing
+shortTitle: Preparing for usage-based billing
+allowTitleToDifferFromFilename: true
+intro: 'If you''re on a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.'
+versions:
+  feature: copilot
+product: '{% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}'
+contentType: how-tos
+category: 
+  - Configure Copilot
+---
+
+<!-- expires 2026-06-01 -->
+
+On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects you before the transition takes effect.
+
+<!-- end expires 2026-06-01 -->
+
+## Download the usage report
+
+From the announcement banner on the premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %} Download CSV** to request a detailed usage report. You can also request the report directly from the premium request analytics page, by clicking **Get usage report**. The report is generated asynchronously and delivered to you via email.
+
+Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
+
+* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
+* `aic_gross_amount`: The estimated cost in USD under usage-based billing
+
+## See projected spend
+
+For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
+
+* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
+* A detailed breakdown of consumed units, included discounts, and additional usage for each billing model.
+
+> [!NOTE]
+> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
+
+Your data stays in your browser; nothing is uploaded to a server.
+
+## Prepare for the transition
+
+* **Understand what consumes credits**. {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_cli_short %}, {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_spaces %}, {% data variables.product.prodname_spark_short %}, and third-party coding agents consume {% data variables.product.prodname_ai_credits_short %}. Code completions and {% data variables.copilot.next_edit_suggestions %} remain unlimited for all paid plans.
+* **Consider your model usage**. Frontier models consume more credits per interaction than lightweight models. Switching to a lighter model for routine tasks can stretch your included usage further.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/billing/usage-based-billing-for-individuals)
 * [AUTOTITLE](/copilot/reference/copilot-billing/models-and-pricing)

content/rest/enterprise-admin/custom-properties-for-orgs.md

@@ -1,9 +1,12 @@
 ---
 title: REST API for organization custom properties in an enterprise
 shortTitle: Custom properties for organizations
-intro: 'Use the REST API to manage custom properties for organizations belonging to an enterprise'
+intro: >-
+  Use the REST API to manage custom properties for organizations belonging to an
+  enterprise
 versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
   ghec: '*'
+  ghes: '>=3.21'
 autogenerated: rest
 allowTitleToDifferFromFilename: true
 category:

content/rest/orgs/custom-properties-for-orgs.md

@@ -4,6 +4,7 @@ shortTitle: Custom properties for organizations
 intro: Use the REST API to manage custom property values for an organization
 versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
   ghec: '*'
+  ghes: '>=3.21'
 autogenerated: rest
 allowTitleToDifferFromFilename: true
 category:

content/rest/repos/tags.md

@@ -4,7 +4,7 @@ allowTitleToDifferFromFilename: true
 shortTitle: Tags
 intro: Use the REST API to manage tags for a repository.
 versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
-  ghes: '*'
+  ghes: <=3.20
 autogenerated: rest
 category:
   - Manage repositories and code