From 1db8f69f1811212c36c6ce53e6ca268e7f1c9683 Mon Sep 17 00:00:00 2001 From: morgankrey Date: Sun, 22 Mar 2026 11:23:02 -0500 Subject: [PATCH] docs: Review pass on BIZOPS-982 and BIZOPS-983 content - Fix writing conventions: sentence case headings throughout, remove em dashes, remove filler phrases ("currently", "have the ability to") - billing.md: fix threshold billing copy, remove self-service blockquote, fix VAT typo, tighten "Please note that" openers - plans-and-usage.md: add plan comparison table, split into per-plan sections, add External Agents and BYOK rows, note Opus unavailable for Student plan, clarify Pro usage billing beyond $5 credit - models.md: note Claude Opus not available on Student plan - privacy-and-security.md: rename to Privacy Overview, rewrite intro, tighten related docs list - privacy.md: humanize prose, add TODO on default-on vs admin config, fix enforcement framing - org-billing.md: fix heading casing, fix "can't" to "cannot" - admin-controls.md: fix heading casing, fix enforcement framing - organizations.md, overview.md, business-support.md: fix heading casing - telemetry.md: split data sharing links to specific anchors Release Notes: - N/A --- docs/src/ai/billing.md | 24 +++++++++---------- docs/src/ai/models.md | 2 ++ docs/src/ai/plans-and-usage.md | 25 ++++++++++---------- docs/src/ai/privacy-and-security.md | 2 +- docs/src/business/admin-controls.md | 8 +++---- docs/src/business/business-support.md | 2 +- docs/src/business/org-billing.md | 10 ++++---- docs/src/business/organizations.md | 10 ++++---- docs/src/business/overview.md | 4 ++-- docs/src/business/privacy.md | 34 +++++++++++++-------------- docs/src/telemetry.md | 2 +- 11 files changed, 62 insertions(+), 61 deletions(-) diff --git a/docs/src/ai/billing.md b/docs/src/ai/billing.md index 7cc141f5d3c1d597d119941e09dc0cda4e988921..c64ff0c12355e543d34354c1e7cb95bdf1dbfa98 100644 --- a/docs/src/ai/billing.md +++ b/docs/src/ai/billing.md @@ -9,18 +9,18 @@ This page covers billing for individual [Zed Pro](./plans-and-usage.md#pro) subs 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. -## Billing Information {#settings} +## Billing information {#settings} Access billing information and settings at [dashboard.zed.dev/account](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 collection of owed monies and prevent abuse. 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. +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, @@ -28,29 +28,27 @@ For example, - 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) -## Updating Billing Information {#updating-billing-info} +## Updating billing information {#updating-billing-info} Email [billing-support@zed.dev](mailto:billing-support@zed.dev) for help updating payment methods, names, addresses, and tax information. -> Self-service billing updates will be available in a future release. +Changes to billing information will **only** affect future invoices. We cannot modify historical invoices. -Please note that changes to billing information will **only** affect future invoices — **we cannot modify historical invoices**. - -## Sales Tax {#sales-tax} +## 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. -If you have a VAT/GST ID, you can add it at during checkout. Check the box that denotes you as a business. +If you have a VAT/GST ID, you can add it during checkout. Check the box that denotes you as a business. -Please note that changes to VAT/GST IDs and address will **only** affect future invoices — **we cannot modify historical invoices**. +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). diff --git a/docs/src/ai/models.md b/docs/src/ai/models.md index a6bb25e929116faf6b75fae14e55f293c85829a5..f178e8044acb606ef47e1cee4459ebb0332df5dc 100644 --- a/docs/src/ai/models.md +++ b/docs/src/ai/models.md @@ -7,6 +7,8 @@ description: AI models available via Zed Pro including Claude, GPT-5.2, Gemini 3 Zed's plans offer hosted versions of major LLMs with higher rate limits than direct API access. Model availability is updated regularly. To use your own API keys instead, see [LLM Providers](./llm-providers.md). For general setup, see [Configuration](./configuration.md). +> **Note:** Claude Opus models are not available on the [Student plan](./plans-and-usage.md#student). + | Model | Provider | Token Type | Provider Price per 1M tokens | Zed Price per 1M tokens | | ---------------------- | --------- | ------------------- | ---------------------------- | ----------------------- | | Claude Opus 4.5 | Anthropic | Input | $5.00 | $5.50 | diff --git a/docs/src/ai/plans-and-usage.md b/docs/src/ai/plans-and-usage.md index 2fe12754f644e657584278968742d8bf71e597f7..d99f2abfb9bfe9542873951243b315bc20f7c9dd 100644 --- a/docs/src/ai/plans-and-usage.md +++ b/docs/src/ai/plans-and-usage.md @@ -11,22 +11,23 @@ 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 | ✓ | ✓ | ✓ | -| Edit Predictions | Limited | Unlimited | Unlimited | -| Enforced data controls | — | — | ✓ | -| RBAC and permissions | — | — | ✓ | -| Consolidated billing | — | — | ✓ | +| | 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 | — | — | ✓ | ## Zed Free {#free} -The editor is free with no time limit. 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 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 Pro {#pro} -Zed Pro includes access to all hosted AI models and Edit Predictions. The plan includes $5 of monthly token credit. A trial of Zed Pro includes $20 of credit, usable for 14 days. +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). @@ -40,7 +41,7 @@ For a full feature overview, see [Zed Business](../business/overview.md). For bi ## 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), and $10/month in token credits. Available free for one year to verified university students. +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. ## Usage {#usage} @@ -56,7 +57,7 @@ The default value for all Pro users is $10, for a total monthly spend with Zed o Once the spend limit is hit, we'll stop any further usage until your token spend limit resets. -> **Note:** Spend limits are a Zed Pro feature. Student plan users do not currently have the ability to configure spend limits; usage is capped at the $10/month included credit. +> **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} diff --git a/docs/src/ai/privacy-and-security.md b/docs/src/ai/privacy-and-security.md index 7444eb97b8da981f5aeec11733068140875458d2..47c92d482e2bdd433c4cb556b18e7e02032d27a4 100644 --- a/docs/src/ai/privacy-and-security.md +++ b/docs/src/ai/privacy-and-security.md @@ -15,7 +15,7 @@ Zed collects minimal data necessary to serve and improve the product. Features t On Zed Business, administrators can enforce these settings org-wide so members can't opt in to data sharing individually. See [Privacy for Business](../business/privacy.md). -## Related Documentation +## Related documentation - [Tool Permissions](./tool-permissions.md): Configure which agent actions are auto-approved, blocked, or require confirmation. - [Worktree Trust](../worktree-trust.md): How Zed opens files and directories in restricted mode. diff --git a/docs/src/business/admin-controls.md b/docs/src/business/admin-controls.md index c6873e54735a754e43b181186e059cf0de617d42..2e556d1e6c8ecdae2c8b84fe11d62ae022689676 100644 --- a/docs/src/business/admin-controls.md +++ b/docs/src/business/admin-controls.md @@ -9,7 +9,7 @@ Owners and admins can configure settings that apply to every member of the organ These controls apply to Zed's server-side features, meaning anything that routes through Zed's infrastructure. They don't cover [bring-your-own-key (BYOK) configurations](../ai/llm-providers.md), [external agents](../ai/external-agents.md), or [third-party extensions](../extensions.md), since those work independently of Zed's servers. -## Accessing Admin Controls +## Accessing admin controls @@ -26,7 +26,7 @@ Administrators can disable Zed's real-time collaboration features for the entire When collaboration is disabled, members won't see collaboration features in their Zed client. -## Hosted AI Models +## Hosted AI models Administrators can control which of Zed's [hosted AI models](../ai/models.md) are available to members: @@ -41,10 +41,10 @@ This applies to Zed's hosted model service only. Members who bring their own API Administrators can disable [Edit Predictions](../ai/edit-prediction.md) for all members of the organization. -## Data Sharing +## Data sharing By default, [data sharing with Zed for AI improvement](../ai/ai-improvement.md) is opt-in for individual users not on a Business plan. Members choose individually whether to share [edit prediction training data](../ai/ai-improvement.md#edit-predictions) or [AI feedback via ratings](../ai/ai-improvement.md#ai-feedback-with-ratings). -Administrators can enforce a no-sharing policy org-wide, blocking members from opting into either form of data sharing. This is enforced server-side, so members can't opt back in individually. +Administrators can enforce a no-sharing policy org-wide; members cannot opt into either form of data sharing. diff --git a/docs/src/business/business-support.md b/docs/src/business/business-support.md index d80ce86b316ea9303518d324b9b1d500b196af77..9655e8aecb32f3aa1de85b1351231bc1c9c8e566 100644 --- a/docs/src/business/business-support.md +++ b/docs/src/business/business-support.md @@ -10,6 +10,6 @@ For business inquiries (account setup, billing, organization questions, or anyth -## Open-Source Issues +## Open-source issues Questions and bugs about the Zed editor itself (features, extensions, language support, crashes) go through the main Zed project on [GitHub](https://github.com/zed-industries/zed/issues). diff --git a/docs/src/business/org-billing.md b/docs/src/business/org-billing.md index 0ac2941572f2226d6246cbed80d5aed34202ea2b..0e1d759afbdc4ab07e389e937df1aac2f1f687f2 100644 --- a/docs/src/business/org-billing.md +++ b/docs/src/business/org-billing.md @@ -9,7 +9,7 @@ description: How billing works for Zed Business organizations, including consoli 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} +## Billing dashboard {#dashboard} @@ -19,7 +19,7 @@ Owners and admins can access billing information at [dashboard.zed.dev](https:// - AI usage and spend across the organization - Per-member usage and spending visibility -## AI Usage {#ai-usage} +## 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. @@ -39,10 +39,10 @@ Invoice history is accessible from the billing dashboard. 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 can't be modified. +Changes to billing information affect future invoices only. Historical invoices cannot be modified. -## Sales Tax {#sales-tax} +## 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. -Questions about tax can go to [billing-support@zed.dev](mailto:billing-support@zed.dev). +Email [billing-support@zed.dev](mailto:billing-support@zed.dev) with any tax questions. diff --git a/docs/src/business/organizations.md b/docs/src/business/organizations.md index 22aea12c913fa98bfdd6941f32b11f6d9a3fa9cc..d8fa746895ffca6960ce22c4c1d4459f16aabf57 100644 --- a/docs/src/business/organizations.md +++ b/docs/src/business/organizations.md @@ -21,13 +21,13 @@ In the Zed editor, an organization menu in the title bar shows your current orga A Zed account can belong to more than one organization at the same time. If you're invited to a second organization while already a member of one, you simply join both. Each organization has its own subscription, billing, and admin controls. -## Creating an Organization +## Creating an organization Organizations are created from the Zed dashboard at [dashboard.zed.dev](https://dashboard.zed.dev). The person who creates the organization becomes its owner. -## Inviting Members +## Inviting members Members are invited by email address. When an invite is accepted, the member's Zed account joins the organization and is covered by its subscription. @@ -40,16 +40,16 @@ To invite a member: After accepting, they authenticate with their GitHub account and are added to the organization. For details on what each role can do, see [Roles & Permissions](../roles.md). -## Managing Members +## Managing members Owners and admins can manage members from the Members page in the dashboard. -### Changing a Member's Role +### Changing a member's role 1. On the Members page, find the member. 2. Open the menu and select a new role. -### Removing a Member +### Removing a member 1. On the Members page, find the member. 2. Select **Remove** and confirm. diff --git a/docs/src/business/overview.md b/docs/src/business/overview.md index 341b50b738dee567abff97211555a217a09d545c..42818f0dff79cae8a7375cebe4156e7085c7ca62 100644 --- a/docs/src/business/overview.md +++ b/docs/src/business/overview.md @@ -9,7 +9,7 @@ Zed Business is Zed for your whole team. Every member gets full Zed Pro access, 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 +## What's included Every member gets full Zed Pro access: all [hosted AI models](../ai/models.md) and [Edit Predictions](../ai/edit-prediction.md). @@ -23,7 +23,7 @@ For the organization: -## Getting Started +## Getting started To set up Zed Business for your team, see [Organizations](./organizations.md). diff --git a/docs/src/business/privacy.md b/docs/src/business/privacy.md index 4da8d8d6b8b04a7b18abea27e4665612c4e48d4b..33e99931a248b89e84f6e2e272625115aad5b385 100644 --- a/docs/src/business/privacy.md +++ b/docs/src/business/privacy.md @@ -1,43 +1,43 @@ --- title: Privacy for Business - Zed Business -description: How Zed Business enforces data privacy across your organization, including auto-enforced prompt and training data protections. +description: How Zed Business handles data privacy across your organization, including enforced protections for prompts and training data. --- # Privacy for Business -On individual Zed plans, privacy protections for AI data are opt-in: members choose whether to share data with Zed for product improvement. On Zed Business, these protections are enforced automatically for all members. No configuration required. +Zed Business removes the per-member data-sharing options that Free and Pro expose. Administrators control these settings for the whole organization; individual members can't opt in or out. -## What's enforced by default + + +## What's enforced For all members of a Zed Business organization: -- **No prompt sharing:** Member conversations and prompts are never shared with Zed. Members can't opt into [AI feedback via ratings](../ai/ai-improvement.md#ai-feedback-with-ratings), which would send conversation data to Zed. -- **No training data sharing:** Member code context is never shared with Zed for [Edit Prediction model training](../ai/ai-improvement.md#edit-predictions). Members can't opt in individually. +- **No prompt sharing:** Conversations and prompts are never shared with Zed. Members can't opt into [AI feedback via ratings](../ai/ai-improvement.md#ai-feedback-with-ratings). +- **No training data sharing:** Code context is never shared with Zed for [Edit Prediction model training](../ai/ai-improvement.md#edit-predictions). Members can't opt in individually. -These protections are enforced server-side. They apply to every org member as soon as they join. +These protections are enforced server-side and apply to all org members. -## How this differs from individual plans +## How individual plans differ -On Free and Pro plans, data sharing is opt-in: +On Free and Pro, data sharing is opt-in: -- Members can choose to rate AI responses, which shares that conversation with Zed. +- Members can rate AI responses, which shares that conversation with Zed. - Members can opt into Edit Prediction training data collection for open source projects. -On Zed Business, neither option is available to members. These aren't configurable settings; they're enforced. +Neither option is available to Zed Business members. ## What data still leaves the organization -These controls cover what Zed stores and trains on. They don't change how AI inference works. - -When members use Zed's hosted AI models, their prompts and code context are sent to the relevant AI provider (Anthropic, OpenAI, Google, etc.) to generate responses. Zed requires zero-data retention agreements with these providers. See [AI Improvement](../ai/ai-improvement.md#data-retention-and-training) for details. +These controls cover what Zed stores and trains on. They don't change how AI inference works: when members use Zed's hosted models, prompts and code context are still sent to the relevant provider (Anthropic, OpenAI, Google, etc.) to generate responses. Zed maintains zero-data retention agreements with these providers. See [AI Improvement](../ai/ai-improvement.md#data-retention-and-training) for details. -[Bring-your-own-key (BYOK)](../ai/llm-providers.md) and [external agents](../ai/external-agents.md) are governed by each provider's own terms; Zed doesn't control how they handle data. +[Bring-your-own-key](../ai/llm-providers.md) and [external agents](../ai/external-agents.md) are subject to each provider's own terms; Zed has no visibility into how they handle data. -## Additional controls for administrators +## Additional admin controls -Administrators can go further using [Admin Controls](./admin-controls.md): +Administrators have additional options in [Admin Controls](./admin-controls.md): -- Disable Zed-hosted models entirely, so no prompts reach Zed's model infrastructure +- Disable Zed-hosted models entirely, so no prompts reach Zed's infrastructure - Disable Edit Predictions org-wide - Disable real-time collaboration diff --git a/docs/src/telemetry.md b/docs/src/telemetry.md index 6d662ea09cec2a0f9100a3348d698af366231f7d..89bc18d79c1b6082cf02c3ccaadbc95fbc647c4f 100644 --- a/docs/src/telemetry.md +++ b/docs/src/telemetry.md @@ -66,7 +66,7 @@ For details on AI data handling, see [Zed AI Features and Privacy](./ai/ai-impro ## Zed Business -Administrators on Zed Business can enforce a no-sharing policy org-wide, blocking members from opting into [edit prediction training data sharing or AI feedback ratings](./ai/ai-improvement.md). See [Data Sharing](./business/admin-controls.md#data-sharing) in Admin Controls. +Administrators on Zed Business can enforce a no-sharing policy org-wide; members can't opt into [edit prediction training data sharing](./ai/ai-improvement.md#edit-predictions) or [AI feedback ratings](./ai/ai-improvement.md#ai-feedback-with-ratings). See [Data Sharing](./business/admin-controls.md#data-sharing) in Admin Controls.