Katie's Copy Updates

Katie Geer created

Change summary

docs/src/SUMMARY.md              |  3 -
docs/src/ai/billing.md           | 63 +++++++++++++++++++++++++--------
docs/src/ai/plans-and-usage.md   | 36 +++++++++---------
docs/src/business/org-billing.md | 48 -------------------------
docs/src/business/overview.md    |  6 +-
5 files changed, 70 insertions(+), 86 deletions(-)

Detailed changes

docs/src/SUMMARY.md 🔗

@@ -59,8 +59,7 @@
 
 - [Authenticate](./authentication.md)
 - [Plans & Pricing](./ai/plans-and-usage.md)
-- [Individual Billing](./ai/billing.md)
-- [Organization Billing](./business/org-billing.md)
+- [Billing](./ai/billing.md)
 
 # Zed Business
 

docs/src/ai/billing.md 🔗

@@ -1,54 +1,87 @@
 ---
-title: Individual Billing
-description: Manage billing for your Zed Pro subscription, including payment methods, invoices, threshold billing, and sales tax information.
+title: Billing
+description: Manage billing for your Zed subscription, including payment methods, invoices, and sales tax information for individual and organization accounts.
 ---
 
-# Individual Billing
+# Billing
 
-This page covers billing for individual [Zed Pro](./plans-and-usage.md#pro) subscriptions. For details on what's included in each plan and how token usage works, see [Plans & Pricing](./plans-and-usage.md). For organization billing, see [Organization Billing](../business/org-billing.md).
+Zed uses Stripe for payment processing. All plans that require payment do so via credit card or other supported payment methods. Individual Pro subscriptions also use Orb for invoicing and metering.
 
-We use Stripe as our payments provider, and Orb for invoicing and metering. All Pro plans require payment via credit card or other supported payment method.
+For details on what's included in each plan and how token usage works, see [Plans & Pricing](./plans-and-usage.md).
 
-## Billing information {#settings}
+## Individual billing {#individual}
 
-Access billing information and settings at [dashboard.zed.dev/account](https://dashboard.zed.dev/account).
+### Billing information {#settings}
+
+Access billing information and settings from your [Zed dashboard](https://dashboard.zed.dev/account).
 This page embeds data from Orb, our invoicing and metering partner.
 
-## Billing cycles {#billing-cycles}
+### Billing cycles {#billing-cycles}
 
 Zed is billed on a monthly basis based on the date you initially subscribe. You'll receive _at least_ one invoice from Zed each month you're subscribed to Zed Pro, and more than one if you use more than $10 in incremental token spend within the month.
 
-## Threshold billing {#threshold-billing}
+### Threshold billing {#threshold-billing}
 
 Zed utilizes threshold billing to ensure timely payment collection. Every time your usage of Zed's hosted models crosses a $10 spend threshold, a new invoice is generated, and the threshold resets to $0.
 
 For example,
 
 - You subscribe on February 1. Your first invoice is $10.
-- You use $12 of incremental tokens in the month of February, with the first $10 spent on February 15. You'll receive an invoice for $10 on February 15
+- You use $12 of incremental tokens in the month of February, with the first $10 spent on February 15. You'll receive an invoice for $10 on February 15.
 - On March 1, you receive an invoice for $12: $10 (March Pro subscription) and $2 in leftover token spend, since your usage didn't cross the $10 threshold.
 
-## Payment failures {#payment-failures}
+### Payment failures {#payment-failures}
 
 If payment of an invoice fails, Zed will block usage of our hosted models until the payment is complete. Email [billing-support@zed.dev](mailto:billing-support@zed.dev) for assistance.
 
-## Invoice history {#invoice-history}
+### Invoice history {#invoice-history}
 
 You can access your invoice history by navigating to [dashboard.zed.dev/account](https://dashboard.zed.dev/account) and clicking `Invoice history` within the embedded Orb portal.
 
-If you require historical Stripe invoices, email [billing-support@zed.dev](mailto:billing-support@zed.dev)
+If you require historical Stripe invoices, email [billing-support@zed.dev](mailto:billing-support@zed.dev).
+
+## Organization billing {#organization}
+
+Zed Business consolidates your team's costs. Seat licenses and AI usage for all members appear on one bill, with no separate invoices per member. For a full feature overview, see [Zed Business](../business/overview.md).
+
+### Billing dashboard {#dashboard}
+
+<!-- TODO: confirm exactly what billing information is shown in the dashboard before launch -->
+
+Owners and admins can access billing information at [dashboard.zed.dev](https://dashboard.zed.dev). The dashboard shows:
+
+- Current member count and seat charges
+- AI usage and spend across the organization
+- Per-member usage and spending visibility
+
+### AI usage {#ai-usage}
+
+AI usage across the organization is metered on a token basis at the same rates as individual Pro subscriptions. See [Plans & Pricing](./plans-and-usage.md#usage) for rate details.
+
+<!-- TODO: confirm org-wide spend limit behavior at launch (how limits are set, what happens when reached) -->
+
+Administrators can set an org-wide AI spend limit from [Admin Controls](../business/admin-controls.md). Once the limit is reached, AI usage is paused until the next billing period.
+
+### Invoice history {#org-invoice-history}
+
+Owners and Admins can access an organizations' invoice history by navigating to [dashboard.zed.dev/account](https://dashboard.zed.dev/account) and clicking `Invoice history` within the embedded Orb portal.
+
+If you require historical Stripe invoices, email [billing-support@zed.dev](mailto:billing-support@zed.dev).
 
 ## Updating billing information {#updating-billing-info}
 
+<!-- TODO: confirm whether owners/admins can update payment methods, addresses, and tax IDs self-serve at launch; if so, replace the below with instructions -->
+
 Email [billing-support@zed.dev](mailto:billing-support@zed.dev) for help updating payment methods, names, addresses, and tax information.
 
 Changes to billing information will **only** affect future invoices. We cannot modify historical invoices.
 
 ## Sales tax {#sales-tax}
 
-Zed partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rate for invoices, based on customer location and the product being sold. Tax is listed as a separate line item on invoices, based preferentially on your billing address, followed by the card issue country known to Stripe.
+Zed partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rates for invoices, based on customer location and the product being sold. Tax is listed as a separate line item on invoices, based preferentially on your billing address, followed by the card issue country known to Stripe.
 
 If you have a VAT/GST ID, you can add it during checkout. Check the box that denotes you as a business.
 
 Changes to VAT/GST IDs and address will **only** affect future invoices. We cannot modify historical invoices.
-Questions or issues can be directed to [billing-support@zed.dev](mailto:billing-support@zed.dev).
+
+Email [billing-support@zed.dev](mailto:billing-support@zed.dev) with any tax questions.

docs/src/ai/plans-and-usage.md 🔗

@@ -11,35 +11,35 @@ Zed works without AI features or a subscription. No [authentication](../authenti
 
 ## Plans {#plans}
 
-|                                           | Free    | Pro       | Business  |
-| ----------------------------------------- | ------- | --------- | --------- |
-| Zed-hosted AI models                      | —       | ✓         | ✓         |
-| [AI via own API keys](./llm-providers.md) | ✓       | ✓         | ✓         |
-| [External agents](./external-agents.md)   | ✓       | ✓         | ✓         |
-| Edit Predictions                          | Limited | Unlimited | Unlimited |
-| Admin-enforced data controls              | —       | —         | ✓         |
-| RBAC and permissions                      | —       | —         | ✓         |
-| Consolidated billing                      | —       | —         | ✓         |
+|                                           | Free    | Pro       | Student   | Business  |
+| ----------------------------------------- | ------- | --------- | --------- | --------- |
+| Zed-hosted AI models                      | —       | ✓         | ✓         | ✓         |
+| [AI via own API keys](./llm-providers.md) | ✓       | ✓         | ✓         | ✓         |
+| [External agents](./external-agents.md)   | ✓       | ✓         | ✓         | ✓         |
+| Edit Predictions                          | Limited | Unlimited | Unlimited | Unlimited |
+| Org-wide admin controls              | —       | —         | —         | ✓         |
+| Roles & permissions                     | —       | —         | —         | ✓         |
+| Consolidated billing                      | —       | —         | —         | ✓         |
 
-## Zed Free {#free}
+### Zed Free {#free}
 
-Zed is free to use. You can use AI with your own API keys via [Providers](./llm-providers.md). [Edit Predictions](./edit-prediction.md) are available on a limited basis. Zed's hosted models require a Pro subscription.
+Zed is free to use. You can configure AI agents with your own API keys via [Providers](./llm-providers.md). [Edit Predictions](./edit-prediction.md) are available on a limited basis. Zed's hosted models require a Pro subscription.
 
-## Zed Pro {#pro}
+### Zed Pro {#pro}
 
 Zed Pro includes access to all hosted AI models and Edit Predictions. The plan includes $5 of monthly token credit; usage beyond that is billed at the rates listed on [the Models page](./models.md). A trial of Zed Pro includes $20 of credit, usable for 14 days.
 
 For details on billing and payment, see [Individual Billing](./billing.md).
 
-## Zed Business {#business}
+### Zed Business {#business}
 
 <!-- TODO: confirm per-seat pricing before launch -->
 
-Zed Business gives every member full Zed Pro access, plus org-wide controls for administrators: which AI features are available, what data leaves your organization, and how AI spend is tracked. All seats and AI usage are consolidated into a single invoice.
+Zed Business gives every member access to all of Zed's hosted AI models, unlimited edit predictions, plus org-wide controls for administrators: which AI features are available, what data leaves your organization, and how AI spend is tracked. All seats and AI usage are consolidated into a single invoice.
 
-For a full feature overview, see [Zed Business](../business/overview.md). For billing details, see [Organization Billing](../business/org-billing.md).
+For a full feature overview, see [Zed Business](../business/overview.md). For billing details, see [Billing](./billing.md#organization).
 
-## Student Plan {#student}
+### Student Plan {#student}
 
 The [Zed Student plan](https://zed.dev/education) includes all Zed Pro features: unlimited [Edit Predictions](./edit-prediction.md), all [hosted AI models](./models.md) except Claude Opus, and $10/month in token credits. Available free for one year to verified university students.
 
@@ -59,6 +59,6 @@ Once the spend limit is hit, we'll stop any further usage until your token spend
 
 > **Note:** Spend limits are a Zed Pro feature. Student plan users cannot configure spend limits; usage is capped at the $10/month included credit.
 
-## Trials {#trials}
+### Trials {#trials}
 
-Trials automatically convert to Zed Free when they end. No cancellation is needed to prevent conversion to Zed Pro.
+Trials automatically convert to Zed Free when they end. Trials do not include access to Anthropic's Opus models. No cancellation is needed to prevent conversion to Zed Pro.

docs/src/business/org-billing.md 🔗

@@ -1,48 +0,0 @@
----
-title: Organization Billing - Zed Business
-description: How billing works for Zed Business organizations, including consolidated invoicing, AI spend limits, and per-member usage visibility.
----
-
-# Organization Billing
-
-<!-- TODO: verify org billing behavior with Cloud team before launch -->
-
-Zed Business consolidates your team's costs. Seat licenses and AI usage for all members appear on one bill, with no separate invoices per member.
-
-## Billing dashboard {#dashboard}
-
-<!-- TODO: confirm exactly what billing information is shown in the dashboard before launch -->
-
-Owners and admins can access billing information at [dashboard.zed.dev](https://dashboard.zed.dev). The dashboard shows:
-
-- Current member count and seat charges
-- AI usage and spend across the organization
-- Per-member usage and spending visibility
-
-## AI usage {#ai-usage}
-
-AI usage across the organization is metered on a token basis at the same rates as individual Pro subscriptions. See [Plans & Pricing](../ai/plans-and-usage.md#usage) for rate details.
-
-<!-- TODO: confirm org-wide spend limit behavior at launch (how limits are set, what happens when reached) -->
-
-Administrators can set an org-wide AI spend limit from [Admin Controls](./admin-controls.md). Once the limit is reached, AI usage is paused until the next billing period.
-
-## Payment and Invoices {#invoices}
-
-Organization billing uses Stripe for payments, via credit card or other supported payment method.
-
-<!-- TODO: confirm whether invoice-based billing is available at launch -->
-
-Invoice history is accessible from the billing dashboard.
-
-<!-- TODO: confirm whether owners/admins can update payment methods, addresses, and tax IDs self-serve at launch; if so, replace the below with instructions -->
-
-For help updating payment methods, names, addresses, or tax IDs, email [billing-support@zed.dev](mailto:billing-support@zed.dev).
-
-Changes to billing information affect future invoices only. Historical invoices cannot be modified.
-
-## Sales tax {#sales-tax}
-
-Zed partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rates based on your billing address. Tax appears as a separate line item on invoices. If you have a VAT/GST ID, add it during checkout.
-
-Email [billing-support@zed.dev](mailto:billing-support@zed.dev) with any tax questions.

docs/src/business/overview.md 🔗

@@ -5,17 +5,17 @@ description: Zed Business gives every team member full Zed Pro access, with org-
 
 # Zed Business
 
-Zed Business is Zed for your whole team. Every member gets full Zed Pro access, and administrators get controls to manage how Zed is used across the organization: which AI features are available, what data leaves your environment, and how AI spend is tracked.
+Zed Business is Zed for your whole team. Every member gets access to Zed's hosted AI models and unlimited Edit Predictions, and administrators get controls to manage how Zed is used across the organization: which AI features are available, what data leaves your environment, and how AI spend is tracked.
 
 It's for teams that want modern AI tooling without security trade-offs, and for companies with procurement or compliance requirements that have blocked Zed deployment.
 
 ## What's included
 
-Every member gets full Zed Pro access: all [hosted AI models](../ai/models.md) and [Edit Predictions](../ai/edit-prediction.md).
+Every member gets access to all [hosted AI models](../ai/models.md) and [Edit Predictions](../ai/edit-prediction.md).
 
 For the organization:
 
-- **Enforced data controls:** Administrators decide which AI features are available. [Zed-hosted models](../ai/models.md), [Edit Predictions](../ai/edit-prediction.md), and [real-time collaboration](../collaboration/overview.md) can be toggled on or off for the whole org. Members can't override these settings individually.
+- **Enforced data controls:** Administrators decide which AI features are available. [Zed-hosted models](../ai/models.md), [Edit Predictions](../ai/edit-prediction.md) can be toggled on or off for the whole org. Members can't override these settings individually.
 - **Private by default:** Zed doesn't store your prompts or train on them without explicit opt-in. [Data sharing for AI improvement](../ai/ai-improvement.md) is opt-in: members can choose to share but are never enrolled automatically. Administrators can enforce this org-wide, blocking members from opting in at all.
 - **RBAC and permissions:** Owners, admins, and members have different access levels. Billing and org settings are only visible to the roles that need them.
 - **Consolidated billing:** Your team's licenses and AI usage appear on one invoice, with no separate bills per member.