Merge pull request #41816 from github/repo-sync

Repo sync

Author: docs-bot

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

@@ -51,7 +51,10 @@ contentType: concepts
 
 ## How use of {% data variables.large_files.product_name_short %} is measured
 
-Each {% data variables.product.github %} account receives a quota of free bandwidth and storage for {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}). Any usage beyond the included amounts is billed to your account. Bandwidth resets every month, while storage usage does not.
+Each {% data variables.product.github %} account receives a quota of free bandwidth and storage for {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}). Any usage beyond the included amounts is billed to your account. 
+
+* **Bandwidth:** Your free quota resets at the start of each billing cycle. 
+* **Storage:** Charges accrue continuously throughout the month based on hourly usage. Your accrued storage total resets to zero at the begining of each billing cycle.
 
 Working in a public or private repository with {% data variables.large_files.product_name_short %}:
 
@@ -86,7 +89,7 @@ The following amounts of storage and bandwidth for downloads are included in you
 | {% data variables.product.prodname_pro %} | {% data variables.large_files.included_bandwidth_free_pro %} | {% data variables.large_files.included_storage_free_pro %} |
 | {% data variables.product.prodname_free_team %} for organizations | {% data variables.large_files.included_bandwidth_free_pro %} | {% data variables.large_files.included_storage_free_pro %} |
 | {% data variables.product.prodname_team %} | {% data variables.large_files.included_bandwidth_team_enterprise %} | {% data variables.large_files.included_storage_team_enterprise %} |
-| {% data variables.product.prodname_ghe_cloud %} | {% data variables.large_files.included_bandwidth_team_enterprise %} | {% data variables.large_files.included_storage_team_enterprise %} |
+|{% data variables.product.prodname_ghe_cloud %} | {% data variables.large_files.included_bandwidth_team_enterprise %} | {% data variables.large_files.included_storage_team_enterprise %} |
 
 ## Using more than your included quota
 

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

@@ -27,11 +27,56 @@ contentType: concepts
 
 {% data variables.product.prodname_actions %} usage is **free** for **self-hosted runners** and for **public repositories** that use standard {% data variables.product.github %}-hosted runners. See [AUTOTITLE](/actions/writing-workflows/choosing-where-your-workflow-runs/choosing-the-runner-for-a-job#standard-github-hosted-runners-for-public-repositories).
 
-For **private repositories**, each {% data variables.product.github %} account receives a quota of free minutes, artifact storage, and cache storage for use with {% data variables.product.github %}-hosted runners, depending on the account's plan. Any usage beyond the included amounts is billed to your account. Minutes reset every month, while artifact and cache storage usage do not.
+For **private repositories**, each {% data variables.product.github %} account receives a quota of free minutes, artifact storage, and cache storage for use with {% data variables.product.github %}-hosted runners, depending on the account's plan. Any usage beyond the included amounts is billed to your account.
+
+* **Minutes:** Your free minutes reset to the full amount at the start of each billing cycle. Minutes usage is charged to the repository owner, not the person who triggered the workflow runs.
+* **Storage:** Storage charges accumulate throughout the month based on hourly usage. Your accrued storage charges reset to zero at the start of each billing cycle.
 
 > [!TIP]
 > Anyone with write access to a repository can run actions without using minutes for their personal account.
 
+## How storage billing works
+
+{% data variables.product.prodname_actions %} storage billing operates on an **hourly accrual model**:
+
+* **Continuous billing:** Storage charges accrue every hour based on your actual usage throughout the month
+* **Monthly total:** Your bill reflects the total storage used throughout the month, measured in GB-Hours
+* **Included amount:** The free storage allowance for your plan (for example, 50 GB on the Enterprise plan) is converted to an hourly rate for billing calculations
+* **Shared storage:** Actions artifacts, Actions caches, and {% data variables.product.prodname_registry %} storage all share the same pooled allowance. For more information, see [AUTOTITLE](/billing/concepts/product-billing/github-packages).
+
+### Understanding current vs. accrued storage
+
+It's important to understand the difference between what you see on {% data variables.product.github %} and what appears on your bill:
+
+* **Current storage:** The amount of storage you have right now (visible in repository settings and the **Billing Overview** page)
+* **Accrued storage:** The cumulative total of storage used throughout the billing cycle (determines your bill)
+
+**When you delete artifacts:**
+* Current storage decreases immediately
+* Future hourly charges stop accumulating
+* Storage already accrued during the current billing cycle remains in your total and will appear on your bill
+
+**Example (30-day billing cycle):** If you store 10 GB of artifacts for 10 days, then delete everything on day 11:
+* Days 1-10: Accruing 240 GB-Hours per day (10 GB × 24 hours)
+* Day 11: Delete artifacts → current storage drops to 0 GB
+* Days 11-30: Accruing 0 GB-Hours (no storage)
+* Your bill: Shows 2,400 GB-Hours total (10 days × 240 GB-Hours/day)
+
+Deleting artifacts reduces your current storage and prevents future charges, but does not remove charges already recorded for the time the storage existed.
+
+### Storage measurement units
+
+{% data variables.product.prodname_actions %} measures storage in **binary gigabytes (GB)**, where:
+* 1 GB = 2^30 bytes = 1,073,741,824 bytes
+* This is also known as a gibibyte (GiB)
+* 1 GB = 1,024 megabytes (MB)
+
+**Billing calculations use GB-Hours:**
+* 1 GB-Hour = 1 GB of storage for 1 hour
+* Example: Storing 3 GB for 10 days = 720 GB-Hours (3 GB × 10 days × 24 hours)
+
+Your monthly bill converts GB-Hours to GB-Months by dividing by the hours in the month (usually 720 hours for a 30-day month).
+
 ### Examples of how usage is measured
 
 * If you run a workflow on a standard Linux runner and it takes 10 minutes to complete, you'll use 10 minutes of the repository owner's allowance. If the workflow generates a 10 MB artifact, then you'll also use 10 MB of the repository owner's artifact storage allowance.
@@ -47,7 +92,8 @@ The following amounts of time for standard runners, artifact storage, and cache
 {% data reusables.billing.actions-included-quotas %}
 
 > [!NOTE]
-> Included minutes cannot be used for larger runners. These runners will always be charged for, even when used by public repositories.
+> * Included minutes cannot be used for larger runners. These runners will always be charged for, even when used by public repositories.
+> * The storage amounts shown are **shared** with {% data variables.product.prodname_registry %}. This means your total storage across Actions artifacts, Actions caches, and Packages cannot exceed the included amount for your plan.
 
 The use of standard {% data variables.product.github %}-hosted runners is free:
 

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

@@ -25,7 +25,10 @@ contentType: concepts
 
 {% data variables.product.prodname_registry %} usage is **free** for **public packages**. In addition, data transferred in from any source is free.
 
-For **private** repositories, each {% data variables.product.github %} account receives a quota of storage and data transfer for use with {% data variables.product.prodname_registry %}, depending on the account's plan. Any usage beyond the included amounts is billed to your account. Data transfer resets every month, while storage usage does not.
+For **private** repositories, each {% data variables.product.github %} account receives a quota of storage and data transfer for use with {% data variables.product.prodname_registry %}, depending on the account's plan. Any usage beyond the included amounts is billed to your account. 
+
+* **Data transfer** Your free quota resets at the start of each billing cycle. 
+* **Storage:** Charges accrue continuously throughout the month based on your hourly usage. At the start of each billing cycle, your accrued storage total resets to zero and begins accumulating again.
 
 Working in a private repository with packages:
 
@@ -57,8 +60,10 @@ Plan | Storage | Data transfer (per month)
 
 {% endrowheaders %}
 
+The storage amounts shown are **shared** with {% data variables.product.prodname_actions %}. This means your total storage across Packages, Actions artifacts, and Actions caches cannot exceed the included amount for your plan.
+
 > [!NOTE]
-> **Billing for container image storage:** Container image storage and bandwidth for the {% data variables.product.prodname_container_registry %} is currently free. If you use {% data variables.product.prodname_container_registry %}, you'll be informed at least one month in advance of any change to this policy. For more information about the {% data variables.product.prodname_container_registry %}, see [AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-container-registry).
+> * **Billing for container image storage:** Container image storage and bandwidth for the {% data variables.product.prodname_container_registry %} is currently free. If you use {% data variables.product.prodname_container_registry %}, you'll be informed at least one month in advance of any change to this policy. For more information about the {% data variables.product.prodname_container_registry %}, see [AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-container-registry).
 
 ### Package downloads by {% data variables.product.prodname_actions %}