[pull] main from github:main

.github/workflows/content-lint-markdown.yml

@@ -24,6 +24,9 @@ jobs:
     steps:
       - name: Check out repo
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - name: Set up Node and dependencies
         uses: ./.github/actions/node-npm-setup

.github/workflows/link-check-on-pr.yml

@@ -30,6 +30,9 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - uses: ./.github/actions/node-npm-setup
 

.github/workflows/readability.yml

@@ -27,10 +27,11 @@ jobs:
     if: github.repository == 'github/docs-internal'
     runs-on: ubuntu-latest
     steps:
-      - name: Check out repo with full history
+      - name: Check out repo
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
         with:
-          fetch-depth: 0
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - name: Checkout PR for manual dispatch
         if: ${{ github.event_name == 'workflow_dispatch' }}

.github/workflows/reviewers-legal.yml

@@ -33,6 +33,9 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v6.0.1
+        with:
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - name: Get changed files
         id: changed_files

.github/workflows/test-changed-content.yml

@@ -28,6 +28,9 @@ jobs:
       # Even if if doesn't do anything
       - name: Check out repo
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - uses: ./.github/actions/node-npm-setup
 

.github/workflows/test.yml

@@ -88,6 +88,9 @@ jobs:
       # Even if if doesn't do anything
       - name: Check out repo
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          # Fetch 2 commits so tj-actions/changed-files can diff without extra API calls
+          fetch-depth: 2
 
       - uses: ./.github/actions/setup-elasticsearch
         if: ${{ matrix.name == 'search' || matrix.name == 'languages' }}

config/kubernetes/default/deployments/webapp.yaml

@@ -25,6 +25,9 @@ spec:
             requests:
               cpu: 1000m
               memory: 4500Mi
+              # Keep ~600 MB headroom above --max-old-space-size in
+              # config/moda/configuration/default/env.yaml for Node
+              # off-heap memory and OS overhead.
             limits:
               cpu: 8000m
               memory: 16Gi

config/kubernetes/production/deployments/webapp.yaml

@@ -30,10 +30,13 @@ spec:
               # Node is single-threaded but we want more CPUs
               # for OS and image resizing, and other binary executions
               # Better to increase replicas or memory than CPU
-              memory: 6.0Gi
+              memory: 8.0Gi
               # Absolute minimum to start app is 4500Mi
               # Would increase with more pages, versions, or languages supported
               # The additional memory helps during traffic surges
+              # Keep ~600 MB headroom above --max-old-space-size in
+              # config/moda/configuration/production/env.yaml for Node
+              # off-heap memory and OS overhead.
             limits:
               cpu: 16000m
               memory: 16Gi

config/moda/configuration/default/env.yaml

@@ -1,6 +1,12 @@
 data:
   MODA_APP_NAME: docs-internal
   NODE_ENV: production
+  # V8 heap limit (--max-old-space-size) should leave at least ~600 MiB
+  # below the K8s memory request for Node off-heap memory (Buffers,
+  # V8 code cache, libuv) and OS overhead. If you change the memory
+  # request in config/kubernetes/default/deployments/webapp.yaml,
+  # update this value to match.
+  # Current: 4500 MiB request, 4096 MiB heap = 404 MiB headroom
   NODE_OPTIONS: '--max-old-space-size=4096'
   PORT: '4000'
   ENABLED_LANGUAGES: 'en,es,ja,pt,zh,ru,fr,ko,de'

config/moda/configuration/production/env.yaml

@@ -1,7 +1,13 @@
 data:
   MODA_APP_NAME: docs-internal
   NODE_ENV: production
-  NODE_OPTIONS: '--max-old-space-size=4096'
+  # V8 heap limit (--max-old-space-size) should leave at least ~600 MiB
+  # below the K8s memory request for Node off-heap memory (Buffers,
+  # V8 code cache, libuv) and OS overhead. If you change the memory
+  # request in config/kubernetes/production/deployments/webapp.yaml,
+  # update this value to match.
+  # Current: 8.0 Gi (8192 MiB) request, 7168 MiB heap = 1024 MiB headroom
+  NODE_OPTIONS: '--max-old-space-size=7168'
   PORT: '4000'
   ENABLED_LANGUAGES: 'en,es,ja,pt,zh,ru,fr,ko,de'
   RATE_LIMIT_MAX: '21'

content/billing/concepts/azure-subscriptions.md

@@ -8,6 +8,8 @@ versions:
   ghes: '*'
 contentType: concepts
 product: 'Organization and enterprise accounts can pay for any metered use of {% data variables.product.github %} using an Azure subscription. This option is not available for personal accounts.'
+category:
+  - Set up payment
 ---
 
 ## Payment using an Azure subscription

content/billing/concepts/billing-cycles.md

@@ -13,6 +13,8 @@ redirect_from:
   - /billing/managing-your-billing/about-the-billing-cycle
 product: '{% data reusables.billing.enhanced-billing-platform-product %}'
 contentType: concepts
+category:
+  - Get started with billing
 ---
 
 Your billing experience depends on whether your products are metered, volume-based, or a combination of both. Some products, like {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_GHAS %}, can be either volume-based or metered, depending on when and how your account was created.

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

@@ -5,6 +5,8 @@ shortTitle: Budgets and alerts
 versions:
   feature: enhanced-billing-platform
 contentType: concepts
+category:
+  - Track spending and control costs
 ---
 
 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.

content/billing/concepts/cost-centers.md

@@ -6,6 +6,8 @@ versions:
   feature: enhanced-billing-platform
 contentType: concepts
 product: '{% data variables.product.prodname_ghe_cloud %}'
+category:
+  - Track spending and control costs
 ---
 
 Cost centers allow you to attribute usage and spending to business units, improving accountability, forecasting, and cost allocation. You can also apply one or more budgets to them to control costs.

content/billing/concepts/discounted-plans.md

@@ -15,6 +15,8 @@ versions:
   ghec: '*'
 shortTitle: Discounted plans
 contentType: concepts
+category:
+  - Get started with billing
 ---
 
 > [!TIP]

content/billing/concepts/enterprise-billing/azure-devops-licenses.md

@@ -7,6 +7,8 @@ versions:
 product: Enterprise accounts using Microsoft Entra ID as their identity provider, see [AUTOTITLE](/enterprise-cloud@latest/admin/managing-iam/provisioning-user-accounts-with-scim/configuring-scim-provisioning-for-users)
 shortTitle: Azure DevOps licenses
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 {% data variables.product.prodname_ghe_cloud %} customers can use Azure DevOps without additional costs per user. For customers using Microsoft Entra, users can sign in with the same credentials on {% data variables.product.github %} and Azure DevOps.

content/billing/concepts/enterprise-billing/billing-for-enterprises.md

@@ -18,6 +18,8 @@ versions:
   ghes: '*'
 shortTitle: Billing for enterprises
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 ## {% data variables.product.prodname_enterprise %} plan costs

content/billing/concepts/enterprise-billing/combined-enterprise-use.md

@@ -9,6 +9,8 @@ shortTitle: Combined enterprise use
 redirect_from:
   - /billing/managing-your-license-for-github-enterprise/about-licenses-for-github-enterprise
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 ## About enterprise deployments

content/billing/concepts/enterprise-billing/ghes-license-files.md

@@ -7,6 +7,8 @@ versions:
   ghes: '*'
 shortTitle: GHES license files
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 ## About license files

content/billing/concepts/enterprise-billing/usage-based-licenses.md

@@ -18,6 +18,8 @@ permissions: Enterprise administrators
 product: '{% data variables.product.prodname_enterprise %}'
 shortTitle: Usage-based licenses
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 Usage-based billing means you pay each month for the number of licenses actually consumed in your enterprise account, instead of committing to a fixed number in advance. This model provides flexibility and can be more cost-efficient than traditional volume licensing.

content/billing/concepts/enterprise-billing/visual-studio-subs.md

@@ -17,6 +17,8 @@ versions:
   ghes: '*'
 shortTitle: Visual Studio subs
 contentType: concepts
+category:
+  - Manage enterprise licenses
 ---
 
 > [!NOTE] Customers with a {% data variables.product.prodname_vs %} bundle can **switch to usage-based billing** for {% data variables.product.prodname_enterprise %} licenses. This allows you to pay for licenses on a flexible monthly cycle for users who are not part of your {% data variables.product.prodname_vs %} subscription. See [AUTOTITLE](/billing/concepts/enterprise-billing/usage-based-licenses).

content/billing/concepts/impact-of-plan-changes.md

@@ -12,6 +12,8 @@ versions:
   ghec: '*'
 shortTitle: Impact of plan changes
 contentType: concepts
+category:
+  - Manage your plan and licenses
 ---
 
 ## How plan changes affect billing

content/billing/concepts/product-billing/git-lfs.md

@@ -41,6 +41,8 @@ redirect_from:
 shortTitle: Git LFS
 product: '{% data reusables.billing.enhanced-billing-platform-product %}'
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 ## How use of {% data variables.large_files.product_name_short %} is measured

content/billing/concepts/product-billing/github-actions.md

@@ -17,6 +17,8 @@ versions:
   ghec: '*'
 shortTitle: GitHub Actions
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 ## How use of {% data variables.product.prodname_actions %} is measured

content/billing/concepts/product-billing/github-advanced-security.md

@@ -19,6 +19,8 @@ versions:
   ghec: '*'
 shortTitle: GitHub Advanced Security
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 ## Licenses for {% data variables.product.prodname_GHAS %}

content/billing/concepts/product-billing/github-code-quality.md

@@ -6,6 +6,8 @@ versions:
   feature: code-quality
 shortTitle: GitHub Code Quality
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 > [!NOTE]

content/billing/concepts/product-billing/github-codespaces.md

@@ -18,6 +18,8 @@ redirect_from:
   - /billing/managing-billing-for-github-codespaces
   - /billing/managing-billing-for-your-products/about-billing-for-github-codespaces
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 ## How use of {% data variables.product.prodname_github_codespaces %} is measured

content/billing/concepts/product-billing/github-copilot-licenses.md

@@ -11,6 +11,8 @@ redirect_from:
   - /billing/managing-billing-for-github-copilot
   - /billing/managing-billing-for-your-products/about-billing-for-github-copilot
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 Usage of {% data variables.product.prodname_copilot %} is measured through a combination of licenses and monthly usage tracking. For more information about how usage costs in {% data variables.product.prodname_copilot_short %} work, see [AUTOTITLE](/billing/concepts/product-billing/github-copilot-premium-requests).

content/billing/concepts/product-billing/github-copilot-premium-requests.md

@@ -4,6 +4,8 @@ intro: 'Learn how premium requests in {% data variables.product.prodname_copilot
 versions:
   feature: copilot
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 Usage of {% data variables.product.prodname_copilot_short %} is measured through a combination of licenses and monthly usage tracking. For more information about how license costs in {% data variables.product.prodname_copilot_short %} work, see [AUTOTITLE](/billing/concepts/product-billing/github-copilot-licenses).

content/billing/concepts/product-billing/github-models.md

@@ -7,6 +7,8 @@ versions:
 redirect_from:
   - /billing/managing-billing-for-your-products/about-billing-for-github-models
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 > [!NOTE]

content/billing/concepts/product-billing/github-packages.md

@@ -15,6 +15,8 @@ versions:
   ghec: '*'
 shortTitle: GitHub Packages
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 ## How use of {% data variables.product.prodname_registry %} is measured

content/billing/concepts/product-billing/github-spark.md

@@ -8,6 +8,8 @@ redirect_from:
   - /copilot/concepts/copilot-billing/about-billing-for-github-spark
   - /copilot/concepts/copilot-billing/billing-for-spark
 contentType: concepts
+category:
+  - Understand product costs
 ---
 
 {% data reusables.copilot.spark-business-intro %}

content/billing/concepts/third-party-payments/github-marketplace-apps.md

@@ -13,6 +13,8 @@ versions:
   ghec: '*'
 shortTitle: GitHub Marketplace apps
 contentType: concepts
+category:
+  - Pay third parties and manage client accounts
 ---
 
 {% data variables.product.prodname_marketplace %} includes apps with free and paid pricing plans. After you purchase and install an app, you can upgrade, downgrade, or cancel **at any time**. This article explains the billing model, that is, what happens when you start, trial, change, or cancel a paid app subscription.

content/billing/concepts/third-party-payments/github-sponsors.md

@@ -12,6 +12,8 @@ versions:
   ghec: '*'
 shortTitle: GitHub Sponsors
 contentType: concepts
+category:
+  - Pay third parties and manage client accounts
 ---
 
 This article describes the billing model for {% data variables.product.prodname_sponsors %} from the sponsor’s point of view.

content/billing/get-started/billing-manager-onboard.md

@@ -8,6 +8,8 @@ versions:
 contentType: get-started
 audience:
   - driver
+category:
+  - Get started with billing
 ---
 
 <!--

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

@@ -26,6 +26,8 @@ versions:
   fpt: '*'
   ghec: '*'
 contentType: get-started
+category:
+  - Get started with billing
 ---
 
 <!--

content/billing/get-started/introduction-to-billing.md

@@ -12,6 +12,8 @@ redirect_from:
   - /billing/reference/previous-billing-platform-endpoints
 shortTitle: Introduction to billing
 contentType: get-started
+category:
+  - Get started with billing
 ---
 
 ## Key functionalities

content/billing/how-tos/manage-for-client/create-as-csp-partner.md

@@ -9,6 +9,8 @@ product: 'Microsoft Cloud Solution Provider (CSP) partners setting up {% data va
 redirect_from:
   - /billing/setting-up-paid-accounts-for-procurement-companies/setting-up-enterprise-accounts-for-procurement-companies/creating-an-enterprise-account-as-a-microsoft-csp-partner
 contentType: how-tos
+category:
+  - Pay third parties and manage client accounts
 ---
 
 ## Prerequisites

content/billing/how-tos/manage-for-client/create-client-enterprise.md

@@ -10,6 +10,8 @@ redirect_from:
   - /billing/setting-up-paid-accounts-for-procurement-companies/setting-up-enterprise-accounts-for-procurement-companies/about-enterprise-accounts-for-procurement-companies
   - /billing/setting-up-paid-accounts-for-procurement-companies/setting-up-enterprise-accounts-for-procurement-companies/creating-and-paying-for-an-enterprise-account-on-behalf-of-a-client
 contentType: how-tos
+category:
+  - Pay third parties and manage client accounts
 ---
 
 ## Prerequisites

content/billing/how-tos/manage-for-client/create-client-org.md

@@ -19,6 +19,8 @@ versions:
 product: '{% data variables.product.github %} partners setting up {% data variables.product.prodname_team %}'
 shortTitle: Create client org
 contentType: how-tos
+category:
+  - Pay third parties and manage client accounts
 ---
 
 If you want to create an enterprise account for a client, see [AUTOTITLE](/billing/how-tos/manage-for-client/create-client-enterprise) or [AUTOTITLE](/billing/how-tos/manage-for-client/create-as-csp-partner).

content/billing/how-tos/manage-for-client/manage-client-org.md

@@ -23,6 +23,8 @@ versions:
 permissions: 'Billing manager or organization owner'
 shortTitle: Manage client org
 contentType: how-tos
+category:
+  - Pay third parties and manage client accounts
 ---
 
 If you're not already billing manager for the organization, an organization owner at your client will need to add you to the organization as a billing manager. See [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization).