First round of Vercel feedback

temporalio · Sep 30, 2024 · 337931a · 337931a
1 parent 2ab79cd
commit 337931a
Showing 1 changed file with 56 additions and 69 deletions.
diff --git a/docs/evaluate/temporal-cloud/pricing.mdx b/docs/evaluate/temporal-cloud/pricing.mdx
@@ -1,6 +1,6 @@
 ---
 id: pricing
-title: Temporal Cloud Pricing
+title: Temporal Cloud pricing
 sidebar_label: Pricing
 sidebar_position: 6
 description: Temporal Cloud offers flexible, predictable pricing for Workflows, Activities, Workers, and storage. Pay for what you use with volume discounts and credit savings.
@@ -30,40 +30,38 @@ tags:
 
 Temporal Cloud is a consumption-based service.
 You pay only for what you use.
-Our pricing reflects your use of _actions_, _storage_, and _support_.
+Our pricing reflects your use of [_Actions_](#action), [_Storage_](#storage), and [_Support_](#support).
 It is flexible, transparent, and predictable so you know your costs.
 
-This page describes the elements of Temporal Cloud pricing for [actions](#action), [storage](#storage), and [services/support](#support).
+This page describes the elements of Temporal Cloud pricing.
 It gives you the information you need to understand and estimate costs for your implementation.
 For more exact estimates, please reach out to [our team](https://pages.temporal.io/ask-an-expert).
 
-Cost and billing information are available directly in the account.
+Cost and billing information are available directly in the Temporal Cloud UI.
 For more information, visit the [Billing and Cost](/cloud/billing-and-cost) page.
 
 ## Temporal Cloud pricing model {#pricing-model}
 
 This section explains the basis of the Temporal Cloud pricing model and how it works.
-Your total invoice each calendar month is the combination of Temporal Cloud consumption (Actions and storage) and support.
+Your total invoice each calendar month is the combination of Temporal Cloud consumption ([Actions](#action) and [Storage](#storage)) and [Support](#support).
 
 ### Actions {#action}
 
 **What are Temporal Actions?**
 
-Actions are the building blocks for Workflow Executions.
-When you execute a Temporal Workflow, its Actions create the ongoing state and progress of your Temporal Application.
-Actions serve as the primary unit of consumption-based pricing for Temporal Cloud.
+Actions are the primary unit of consumption-based pricing for Temporal Cloud.
+They track billable operations within the Temporal Cloud Service, such as starting Workflows, recording a Heartbeat or sending messages.
 
-The following operations result in Actions:
 <details>
 
 <summary>
-View operations and Actions
+[Toggle to View] The following operations result in Actions:
 </summary>
 
 **WORKFLOWS**
 
 - **Workflow started**.
-  Occurs via client start, client Signal-With-Start, [Continue-As-New](/workflows#continue-as-new), or [Child Workflow](/encyclopedia/child-workflows) start.
+  Occurs via client start, client [Signal-With-Start](/encyclopedia/workflow-message-passing#signal-with-start), [Continue-As-New](/workflows#continue-as-new), or [Child Workflow](/encyclopedia/child-workflows) start.
   If a Workflow start fails, an Action is not recorded.
 - **Workflow reset**.
   Occurs when a [Workflow](/workflows) is reset.
@@ -127,7 +125,7 @@ Each execution of a Schedule accrues three actions:
 
 ### Storage {#storage}
 
-**How Workflow storage works**
+**How Workflow Storage works**
 
 A particular Workflow's execution might exist for a few seconds, a day, month, or even forever.
 The Temporal Service stores the Workflow Execution's [Event History](/workflows#event-history).
@@ -138,22 +136,22 @@ Under this framework, a Workflow Execution has only two states, open (Active Sto
 - When the execution of a Workflow finishes, Temporal Cloud stores Event History for a defined Retention Period, which is set by the user per Namespace.
   This is _Retained Storage_.
   Typical uses of Retained Storage include compliance, debugging, workload refresh, and business analytics.
-  When retention of closed Workflow histories are needed for longer than the maximum 90-day period on Temporal Cloud, we recommend using our **Export** feature.
+  When closed Workflow Histories need to be retained for more than the 90-day maximum period on Temporal Cloud, we recommend using our [**Export**](/cloud/export) feature.
 
 Storage costs are measured in gigabyte-hours (GBh) and they are measured per Namespace.
 
 ### Support {#support}
 
-**How Temporal support tiers work**
+**How Temporal Support tiers work**
 
 Each Temporal Cloud account includes access to expert support.
 The Temporal Developer Success team has extensive knowledge of how Temporal operates and how to optimize your deployment.
 Our team consists of engineers who are well-versed in Temporal and actively contribute to its development.
 
-Each account is required to have a support plan.
-We offer two support tiers: Basic and Premium.
-Support costs are outlined in the table below
-A complete description of support plans and response times can be found in our [Support](/cloud/support#support) documentation.
+Each account is required to have a Support plan.
+We offer two Support tiers: Basic and Premium.
+Support costs are outlined in the table below.
+A complete description of Support plans and response times can be found in our [Support](/cloud/support#support) documentation.
 
 |                     | Basic                                       | Premium                                       |
 | ------------------- | ------------------------------------------- | --------------------------------------------- |
@@ -163,46 +161,46 @@ A complete description of support plans and response times can be found in our [
 
 **How to Pay for Temporal Cloud**
 
-Temporal Cloud offers two payment options: pay-as-you-go and the pre-purchase of Temporal Credits.
-Both models meter and bill for three components: Actions, Storage, and Support.
+Temporal Cloud offers two payment options: pay-as-you-go and Temporal Credits.
+Both models meter and bill for three components: [Actions](#action), [Storage](#storage), and [Support](#support).
 
 - With pay-as-you-go, you are invoiced each calendar month based on your consumption.
+  Pay-as-you-go pricing applies a flat rate for Actions and Storage.
 - With Temporal Credits, you pre-purchase your Temporal Cloud spend.
-  Temporal Credits are used to pay your Temporal Cloud consumption, including support charges. Purchasing Temporal Credits provides [volume pricing](#prepaid).
+  Temporal Credits are used to pay your Temporal Cloud consumption, including Support charges. Purchasing Temporal Credits provides [volume pricing](#prepaid).
 
-Temporal Credits are used to pay your Temporal Cloud consumption, including support charges.
-A Temporal Credit is equivalent to &#36;1USD.
-For example, a credit purchase of &#36;3,000 results in &#36;3,000 Temporal Credits.
-The minimum purchase of Temporal Credits purchase is &#36;2,500.
+A Temporal Credit is equivalent to &#36;1 USD.
+For example, a credit purchase of &#36;3,000 results in 3,000 Temporal Credits.
+The minimum purchase of Temporal Credits is &#36;2,500.
 Each month, your total invoice draws down from your Temporal Credits balance.
 
 Once you run out of Temporal Credits, you'll be automatically invoiced for &#36;2,500 or your last month's Temporal Cloud invoice multiplied by 12, whichever is greater.
 
 ### How to purchase Temporal Credits? {#purchasing-credits}
 
 You may purchase Temporal Credits by contacting our team at [[email protected]](mailto:[email protected]) or reaching out to your dedicated account manager.
-Temporal Cloud credits are also available for purchase available through AWS Marketplace.
+Temporal Cloud credits are also available for purchase through AWS Marketplace.
 
 ## Pay-as-you-go {#payg}
 
-**How does pay-as-you-go pricing work for Actions, storage, and support?**
+**How does pay-as-you-go pricing work?**
 
 Pay-as-you-go uses consumption pricing.
-This section explains how you're billed each calendar month and gives examples for each pricing style.
+This section explains how you're billed each calendar month and gives examples.
 
 ### Action pricing {#payg-action-pricing}
 
 You are only billed for the Actions you use.
 Actions are metered and billed on a calendar month for each Namespace.
-The pay-as-you-go rate is &#36;25 per one million Actions per month.
+The pay-as-you-go rate is &#36;25 per million Actions per month.
 This rate applies across all Namespaces:
 
-| Actions | &#36;25 per one million Actions |
+| Actions | &#36;25 per million Actions |
 | ------- | --------------------------------|
 
 **Example**
 
-If you use fewer than one million Actions per month, your bill for Actions will be less than &#36;2525 for that month.
+If you use fewer than one million Actions per month, your bill for Actions will be less than &#36;25 for that month.
 For example, if you use 800,000 Actions in a month, you're billed:
 
 ```
@@ -220,12 +218,12 @@ You are billed for  your Namespace’s Active and Retained Storage each calendar
 
 **Example**
 
-If you have 720 GBhr of Active Storage and 3,600 GBhr of Retained Storage in one calendar month your bill will be:
+If you have 720 GBh of Active Storage and 3,600 GBh of Retained Storage in one calendar month your bill will be:
 
 ```
 720 GBh Active Storage ⨉ $0.042 per GBh = $30.24
 3,600 GBh Retained Storage ⨉ $0.00042 per GBh = $1.51
-Total Storage Bill: $30.24 Active Storage + $1.512 Retained Storage = $31.75
+Total Storage Bill: $30.24 Active Storage + $1.51 Retained Storage = $31.75
 ```
 
 ### Support pricing {#payg-support-pricing}
@@ -235,7 +233,7 @@ Support pricing offers [two tiers](/cloud/support#support):
 - Basic Support is priced at the greater of &#36;200/month or 10% of Temporal Cloud consumption.
 - Premium Support is priced at the greater of &#36;2,000/month or 10% of Temporal Cloud consumption.
 
-Temporal Cloud consumption is based on the combined cost of Actions and Storage.
+Temporal Cloud consumption is based on the combined cost of [Actions](#action) and [Storage](#storage).
 
 **Example**
 
@@ -247,11 +245,12 @@ Max of $200 or 10% ⨉ ($20 (Actions) + $31.75 (Storage)) = $5.18, so $200.
 
 ## Prepaid Temporal Credits {#prepaid}
 
-**Credit pricing for Actions, Storage, and Support**
+**Credits Pricing**
 
-Temporal Credits unlock volume pricing for Temporal Cloud.
-Credits cover your Action and Storage costs for Temporal Cloud, along with support fees.
-The following sections introduce how this works.
+With Temporal Credits, you pre-purchase your Temporal Cloud spend.
+Temporal Credits are used to pay your Temporal Cloud consumption, including support charges.
+Purchasing Temporal Credits provides volume pricing.
+The following sections explains how you are invoiced each calendar month and gives examples.
 
 ### Action Credit pricing {#prepaid-action}
 
@@ -301,10 +300,10 @@ Pricing tiers are applied per Namespace each calendar month:
 | **Active Storage (Per Namespace)** | **Price per GBh (USD)**    |
 | ---------------------------------------------- | -------------- |
 | Up to 7,000 GBh                                | &#36;0.039     |
-| Over 7,000, up to 30,000                       | &#36;0.031     |
-| Over 30,000, up to 90,000                      | &#36;0.023     |
-| Over 90,000, up to 400,00                      | &#36;0.018     |
-| Over 400,000, up to 1,500000                   | &#36;0.013     |
+| Next 23,000, up to 30,000                      | &#36;0.031     |
+| Next 60,000, up to 90,000                      | &#36;0.023     |
+| Next 310,000, up to 400,000                    | &#36;0.018     |
+| Next 1,100,000, up to 1,500,000                | &#36;0.013     |
 | Over 1,500,000                                 | &#36;0.010     |
 
 Retained Storage is priced at a flat rate:
@@ -326,7 +325,7 @@ Your Temporal Credits consumed will be:
   5,000 GBh ⨉ $0.039 per GBh = $195 (Active Storage)
   ```
 
-- Retained storage for `namespace1` is charged at &#36;0.00042 GBh:
+- Retained Storage for `namespace1` is charged at &#36;0.00042 GBh:
 
   ```
   5,000 GBh ⨉ $0.00042 per GBh = $2.10 (Retained Storage)
@@ -341,7 +340,7 @@ Your Temporal Credits consumed will be:
   Total: $273 (7,000 GBh) + $248 (8,000 GBh) = $521 (Active Storage)
   ```
 
-- Retained storage for `namespace2` is charged at &#36;0.00042 GBh:
+- Retained Storage for `namespace2` is charged at &#36;0.00042 GBh:
 
   ```
   15,000 GBh ⨉ $0.00042 per GBh = $6.30 (Retained Storage)
@@ -355,21 +354,9 @@ Your Temporal Credits consumed will be:
   Total Storage: $716 (Active Storage) + $8.40 (Retained Storage) = $724.40
   ```
 
-**Example**
-
-In the previous examples for Actions and Storage credit billing, the account had a &#36;13,060 bill for Actions, a &#36;724.40 bill for storage for a total Temporal Cloud consumption bill of &#36;13,784.40.
-
-If the account has Premium Support, the fee will be the greater of &#36;2,000 or 10% Temporal Cloud consumption:
-
-```
-$13,784.40 Total Consumption ⨉ 10% = $1,378.44
-```
-
-Since &#36;2,000 is greater than &#36;1,378.44, the support fee would be &#36;2,000.
-
 ### Support Credit pricing {#prepaid-support}
 
-Prepaid support pricing is based on tiers:
+Prepaid Support pricing is based on tiers:
 
 - Basic Support is the greater of &#36;200 or 10% of Temporal Cloud consumption.
 - Premium Support is the greater of &#36;2,000 or 10% of Temporal Cloud consumption.
@@ -386,16 +373,16 @@ If the account has Premium Support, the fee will be the greater of &#36;2,000 or
 $13,784.4 Total Consumption ⨉ 10% = $1,378.44
 ```
 
-Since &#36;2,000 is greater than &#36;1,378.44, the support fee would be &#36;2,000.
-You are invoiced for your support fee plus your Temporal Cloud consumption.
+Since &#36;2,000 is greater than &#36;1,378.44, the Support fee would be &#36;2,000.
+You are invoiced for your Support fee plus your Temporal Cloud consumption.
 
 ### Credit Balance
 
 Your Credit Balance is adjusted each calendar month based on your Credit Usage.
 
 **Example**
 
-In the previous examples for Actions and storage Credit billing, the account had a total bill of &#36;13,784.40 and &#36;2,000 for support.
+In the previous examples for Actions and Storage Credit billing, the account had a total bill of &#36;13,784.40 and &#36;2,000 for Support.
 The total bill is the sum of these line items, or &#36;15,784.40.
 
 The invoice will state that you now have 120,000 - 15,784.40 = 104,215.60 Temporal Credits remaining.
@@ -404,36 +391,36 @@ If you have additional questions about credits and volume-based pricing, please
 
 ## Other pricing {#other-pricing}
 
-Temporal Cloud may have additional pricing for  other elements of the platform.
+Temporal Cloud has additional pricing for other elements of the platform.
 Following are additional pricing considerations for Multi-region Namespaces and SSO/SAML.
 
 ### Multi-region Namespace (MRN) pricing {#multi-region}
 
-**How does MRN costs work?**
+**How do MRN costs work?**
 
 For workloads with stringent high-availability requirements, Temporal Cloud provides multi-region Namespaces (MRNs), which add a failover capability.
 Each multi-region Namespace automatically replicates Workflow Execution data and metadata to a standby region.
 This keeps the standby region in sync, allowing for a near-seamless failover should regional outages occur.
 
 Multi-region Namespace pricing align with the volume of your workloads.
 After activation, the new MRN begins replicating data to the standby region.
-Due to this replication, MRNs double your current Action and storage costs.
-To estimate costs for this deployment model, apply a 2x multiplier to your existing Actions and storage Namespace costs.
+Due to this replication, MRNs double your current [Action](#action) and [Storage](#storage) costs.
+To estimate costs for this deployment model, apply a 2x multiplier to your existing Actions and Storage Namespace costs.
 
 When upgrading an existing Namespace, some points to consider:
 
 - Temporal won't charge for historical Actions completed prior to upgrading to a multi-region Namespace.
   Only ongoing (in-flight) and new Workflow Executions incur the \"2x\" charge, as these are actively replicated.
 - Temporal charges for all Actions of existing (ongoing) and new Workflows from the point of adding a new region and provisioning multi-region Namespace service onward.
-- Temporal charges for replicated storage of retained (historical), running (ongoing), and new Workflow Executions from the point of adding a new region and starting MRN service.
+- Temporal charges for Replicated Storage of retained (historical), running (ongoing), and new Workflow Executions from the point of adding a new region and starting MRN service.
 
 Multi-region Namespace invoice charges will include:
 
 - An Actions row, showing the Action count from the active region.
 - A Replicated Actions row, showing the Action count from the standby region.
 
 The invoice follows a similar structure for Replicated Storage.
-It breaks out storage and replicated storage into their own line items.
+It breaks out Storage and Replicated Storage into their own line items.
 
 :::tip Action counts for mid-month adoption
 
@@ -455,10 +442,10 @@ We offer single sign-on (SSO) integration using SAML at a monthly fixed fee base
 
 ### Use case cost estimates {#pricing-estimates}
 
-Temporal Cloud uses a consumption-based pricing model based primarily on Actions and storage.
+Temporal Cloud uses a consumption-based pricing model based primarily on [Actions](#action) and [Storage](#storage).
 Each workload is different.
 You can estimate the cost of a specific Workflow by running it at a low volume.
-Use the resulting storage and compute measurements to project your production scale cost.
+Use the resulting Storage and compute measurements to project your production scale cost.
 
 The examples below provide general estimates based on workload size.
 You can also use our calculator on the pricing page to build your estimate.
@@ -495,7 +482,7 @@ You can purchase Temporal Cloud credits by contacting our team at [sales@tempora
 
 The Temporal Cloud service is consumption-based.
 You pay only for what you need with no minimum usage requirement.
-Basic support has a monthly fee starting from &#36;200.
+Basic Support has a monthly fee starting from &#36;200.
 
 **Can I purchase Temporal Cloud through my Amazon, Azure, or Google Cloud Platform marketplace?**