1
0
mirror of synced 2025-12-26 05:05:18 -05:00
Files
airbyte/docusaurus/platform_versioned_docs/version-2.0/using-airbyte/workspaces.md
devin-ai-integration[bot] 34282926a1 docs: Generate version 2.0 of platform documentation (#68102)
## What

Generates version 2.0 of the Airbyte platform documentation using
Docusaurus's built-in versioning system. This creates a frozen snapshot
of the current documentation that users can reference.

Requested by ian.alton@airbyte.io via [Slack
thread](https://airbytehq-team.slack.com/archives/D08FX8EC9L0/p1760490197805979?thread_ts=1760490197.805979).

Link to Devin run:
https://app.devin.ai/sessions/689693593bac44f4903f476aa17b872e

## How

- Ran `pnpm run docusaurus docs:version:platform 2.0` in the docusaurus
directory
- This automatically:
- Created `platform_versioned_docs/version-2.0/` containing a snapshot
of all current platform docs
- Created `platform_versioned_sidebars/version-2.0-sidebars.json` with
the sidebar navigation structure
  - Updated `platform_versions.json` to add "2.0" to the version list
- Ran prettier to format the JSON files
- Verified the documentation builds successfully locally (build
completed in ~3 minutes with only pre-existing broken anchor warnings)

## Review guide

1. **Verify timing**: Confirm this is the correct time to release
version 2.0 of the documentation
2. **Version order**: Check `docusaurus/platform_versions.json` - verify
"2.0" is first in the array (newest version first)
3. **Build verification**: Ensure CI/Vercel builds pass without errors
4. **Spot check**: Optionally review 2-3 files in
`docusaurus/platform_versioned_docs/version-2.0/` to ensure content
looks reasonable

Note: This is a standard Docusaurus versioning operation that creates a
frozen snapshot of the current "next" documentation. The generated files
are extensive (500+ files) but follow Docusaurus conventions.

## User Impact

Users will see version 2.0 available in the version dropdown on
docs.airbyte.com. This provides a stable reference point for platform
documentation at this point in time. Existing versions (1.6, 1.7, 1.8)
remain unchanged.

## Can this PR be safely reverted and rolled back?

- [x] YES 💚

This is an additive change that doesn't modify existing versioned docs.
Reverting would simply remove version 2.0 from the version list and
delete the associated documentation files.

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: ian.alton@airbyte.io <ian.alton@airbyte.io>
2025-10-14 18:27:24 -07:00

2.9 KiB
Raw Blame History

products
products
cloud, oss-enterprise

Manage workspaces

You can create, manage, and delete workspaces, and control access to them.

Create a new workspace

Organization admins and readers can create workspaces. Follow these steps to create a new workspace.

  1. Go to your Organization home page.

  2. Click New workspace.

  3. Enter a workspace name and select a region.

  4. Click Create workspace. Airbyte creates a new, empty workspace.

Rename a workspace

Workspace admins can rename workspaces. Follow these steps to rename a workspace.

  1. Switch to the workspace you want to rename.

  2. Click Workspace settings > General.

  3. Under Workspace name, type the new name.

  4. Click Save changes. Airbyte renames your workspace.

Delete a workspace

Organizations admins and editors, and workspace admins, can delete a workspace. Follow these steps to delete a workspace.

:::danger Deleting a workspace deletes all its sources, destinations, and connections. This is irreversible. Think carefully before doing this. :::

  1. Switch to the workspace you want to delete.

  2. Click Workspace settings > General.

  3. Click Delete your workspace.

  4. Type your workspace name to confirm you want to delete it.

  5. Click Delete workspace. Airbyte permanently deletes your workspace.

Add users to your workspace

Workspace admins can add any organization member to a workspace.

  1. Switch to the workspace you want to add them to.

  2. Click Workspace settings > Members.

  3. Click New member.

  4. Start entering the person's name or email to find them in the list.

  5. Click their name to select them, then assign them an RBAC role.

  6. Click Add new member.

Remove someone from your workspace

Workspace admins can remove someone from a workspace, but can't remove other workspace admins. Follow these steps to remove someone from your workspace.

  1. Switch to the workspace you want to remove them from.

  2. Click Workspace settings > Members.

  3. Find the person you want to remove, click the role next to their name, and select Remove user from workspace.

Switch between workspaces

If you have multiple workspaces in the same organization, you can switch between them. Any workspace reader, runner, editor, or admin can open a workspace.

  1. In the navigation bar, under Workspace, click the dropdown with your current workspace name.

  2. Find and click the name of the workspace you want to switch to. Airbyte switches to that workspace.

Managing roles

See Role based access control to learn more about the different roles available. If you're on the Cloud Standard plan, all users are admins.