From dc54762a81df0c3bb01b231620dc52910dd7592b Mon Sep 17 00:00:00 2001 From: morgankrey Date: Thu, 19 Mar 2026 06:29:08 -0500 Subject: [PATCH] docs: Revise Zed Business pages based on positioning review - Reframe Overview intro for external audience (customer value, not procurement framing) - Add personal org and multi-org membership to Organizations - Confirm email-only invites in Organizations - Move admin controls access section to top of Admin Controls - Scope admin controls to Zed server-side features; note BYOK and extensions are not covered - Replace telemetry toggle with data sharing controls (edit prediction and agent panel) to match launch scope - Update model controls to all-or-nothing / by provider (not per-model) - Link to Collaboration docs with correct terminology - Simplify Business Support page (dedicated support not at launch) - Replace "one invoice" with "unified invoices" throughout - Humanize overview bullet points Release Notes: - N/A --- docs/src/business/admin-controls.md | 60 +++++++++++++++++++---------- docs/src/business/organizations.md | 47 ++++++++++++++-------- docs/src/business/overview.md | 45 ++++++++++++---------- 3 files changed, 95 insertions(+), 57 deletions(-) diff --git a/docs/src/business/admin-controls.md b/docs/src/business/admin-controls.md index 44319f6e7ecde3d2c709c4d002aa3b52b0db6c0d..481325c16b61ae675006f306cd82dde6ea2798a0 100644 --- a/docs/src/business/admin-controls.md +++ b/docs/src/business/admin-controls.md @@ -1,45 +1,63 @@ --- title: Admin Controls - Zed Business -description: Configure AI, collaboration, and privacy settings for your entire Zed Business organization. +description: Configure AI, collaboration, and data sharing settings for your entire Zed Business organization. --- # Admin Controls -Owners and admins can configure settings that apply to every member of the -organization. These controls let you set consistent policies for AI usage, -collaboration, and data sharing across your team. +Owners and admins can configure settings that apply to every member of the organization. + +These controls cover Zed's server-side features — things that route through Zed's +infrastructure. They don't cover bring-your-own-key (BYOK) configurations or +third-party extensions, since Zed is open source and those work independently of +Zed's servers. + +## Accessing Admin Controls + + + +Admin controls are available to owners and admins from the organization dashboard at +[dashboard.zed.dev](https://dashboard.zed.dev). + +--- ## Collaboration -You can disable Zed's real-time collaboration features for your organization. When -disabled, members cannot use channels, shared projects, or live editing. +You can disable Zed's real-time collaboration features for the entire organization. +This covers [Channels](../collaboration/channels.md), shared projects, and voice chat — +the features available in the +[Collaboration Panel](../collaboration/overview.md). + +When collaboration is disabled, members won't see collaboration features in their Zed +client. - + ## Hosted AI Models -You can control which AI models are available to members through Zed's hosted -service. Options include: +You can control which of Zed's hosted AI models are available to members. Options are: -- Disabling all hosted models, so members must bring their own API keys -- Restricting which models are available from the hosted service +- Disable all Zed-hosted models entirely, so members must use their own API keys via + [Providers](../ai/llm-providers.md) if they want AI features +- Enable or disable access by model provider (Anthropic, OpenAI, Google, etc.) - +This control only applies to Zed's hosted model service. Members who bring their own +API keys are not affected. + + ## Edit Predictions You can disable Zed's Edit Predictions for all members of the organization. -## Telemetry and Training Data Sharing - -You can disable telemetry and training data sharing for all members of the organization. -See [Privacy for Business](../privacy-for-business.md) for details on what this covers. +## Data Sharing with Zed - +You can block members from sharing data with Zed for product improvement purposes. +This covers: -## Accessing Admin Controls +- Edit prediction feedback and training data +- Agent panel interactions shared with Zed - +This is enforced at the org level — members can't opt back in individually. -Admin controls are available to owners and admins from the organization dashboard at -[dashboard.zed.dev](https://dashboard.zed.dev). + diff --git a/docs/src/business/organizations.md b/docs/src/business/organizations.md index 919c7816577afd4ccf5c34944e3ab65a458a8eb5..25a0c594bab2706446f4f41a2603b81f56fc97f0 100644 --- a/docs/src/business/organizations.md +++ b/docs/src/business/organizations.md @@ -6,34 +6,48 @@ description: Create and manage a Zed Business organization, invite members, and # Organizations A Zed organization is the container for your team's Zed Business subscription. It -groups your members under a single account, with centralized billing and shared admin +groups your members under a single account with centralized billing and shared admin controls. +## Personal Organizations + +Every Zed account comes with a personal organization created automatically at sign-up. +This is your individual workspace — your own subscription, billing, and settings, separate +from any team you belong to. + +Your personal organization always stays active. Joining a Zed Business organization +doesn't replace or affect it. You can switch between organizations from the organization +menu in the title bar. + +## Multiple Organizations + +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 -You create an organization from the Zed dashboard at -[dashboard.zed.dev](https://dashboard.zed.dev). Once created, you become the -organization owner. +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 -Members are invited by email. When an invitation is accepted, the member's Zed account -is added to the organization and covered by the organization's subscription. - - +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. To invite a member: 1. Go to the Members page in your organization dashboard. 2. Select **+ Invite Member**. 3. Enter the member's email address and choose a role. -4. The invitee receives an email with instructions to join. - -After accepting, the member authenticates via GitHub and is added to the organization. +4. They'll receive an email with a link to join. -For details on what each role can do, see [Roles & Permissions](./roles.md). +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 @@ -49,12 +63,13 @@ Owners and admins can manage members from the Members page in the dashboard. 1. On the Members page, find the member. 2. Select **Remove** and confirm. -Removing a member ends their access to organization-managed features. They can continue -using Zed individually. +Removing a member ends their access to the organization's subscription and admin-managed +settings. Their personal Zed account and any other organization memberships are +unaffected. ## Organization Dashboard -The organization dashboard shows members, roles, and billing. Owners and admins can -access all settings; members have no access to the dashboard. +The dashboard shows your members, roles, and billing. Owners and admins have full +access; members have no dashboard access. diff --git a/docs/src/business/overview.md b/docs/src/business/overview.md index 622ef66e9b372cfb708a02d5d81d0a73bd64cf19..84c5a669248e1b2eedf7c0cd79b7113ca65c81ab 100644 --- a/docs/src/business/overview.md +++ b/docs/src/business/overview.md @@ -1,29 +1,37 @@ --- title: Zed Business -description: Zed Business gives teams centralized billing, admin controls, and enforced privacy settings for every member of your organization. +description: Zed Business gives teams centralized billing, org-wide admin controls, and enforced privacy settings for every member of your organization. --- # Zed Business -Zed Business is a plan for organizations where developers have already chosen Zed but -need admin controls to get it approved. It adds org-wide data controls, centralized -billing, and RBAC — the things security teams and engineering leaders need to say yes. +Zed Business is Zed for your whole team. Every member gets full Zed Pro access, and +administrators get the controls they need to manage how Zed is used across the +organization — what AI features are available, what data leaves your environment, and +how AI spend is tracked. + +It's designed for teams that want modern AI tooling without compromising on security or +privacy, and for companies that need to meet procurement and compliance requirements +before they can deploy new developer tools. ## What's Included -Every member of a Zed Business organization gets full Zed Pro features, including all -hosted AI models and Edit Predictions. +Every member gets full Zed Pro access: all hosted AI models and Edit Predictions. + +For the organization: -For the organization as a whole: +- **Org-wide data controls** — administrators decide what data leaves your environment. + Zed-hosted AI, Edit Predictions, and real-time collaboration can be toggled on or off + for the whole org. Members don't need to configure anything individually. +- **Private by default, not by configuration** — Zed doesn't store your team's prompts + or train on them, and that's not something members can change on their own. +- **RBAC and permissions** — owners, admins, and members each have clearly defined + access. Billing and org settings are only available to the roles that need them. +- **Unified invoices** — your team's licenses and AI usage go on one Zed account. No + separate bills per member. -- **Org-wide data controls** — administrators can restrict what data leaves the - organization: Zed-hosted AI models, Edit Predictions, collaboration, and telemetry - can all be disabled at the org level -- **Private by default, not by configuration** — Zed does not store your team's prompts - or train on them; this applies regardless of individual member settings -- **RBAC & permissions** — role-based access across the organization, with Owner, Admin, - and Member roles -- **Centralized billing** — one invoice covering all members' licenses and AI usage + + ## How It Differs from Pro @@ -32,11 +40,8 @@ For the organization as a whole: | Hosted AI models | — | ✓ | ✓ | | Edit Predictions | — | ✓ | ✓ | | Org-wide data controls | — | — | ✓ | -| RBAC & permissions | — | — | ✓ | -| Centralized billing | — | — | ✓ | - - - +| RBAC and permissions | — | — | ✓ | +| Unified invoices | — | — | ✓ | ## Getting Started