Skip to content

docs: add "Managing your organization" reference (leave + delete)#609

Merged
charliedowler merged 6 commits into
mainfrom
leave-org
May 12, 2026
Merged

docs: add "Managing your organization" reference (leave + delete)#609
charliedowler merged 6 commits into
mainfrom
leave-org

Conversation

@charliedowler
Copy link
Copy Markdown
Contributor

Summary

Documents the Danger zone in Settings → General:

  • New page references/workspace/managing-your-organization — covers leaving an organization (any member), deleting an organization (admin only), and the "at least one admin" constraint. Cross-links the equivalent SCIM rule for consistency.
  • Nav update — slotted the new page under Workspace and user management → Admin, between user-impersonation and how-to-create-multiple-projects.
  • invite-new-users callout — explains the "Email is already used by a user in another organization" error and points readers at the new page for the recovery flow.

Pairs with

Notes for the reviewer

  • The leave-organization feature is feature-flagged (leave-organization, off by default). The new page flags this with an <Info> block at the top of the section, matching the convention used in user-impersonation.mdx.
  • No screenshots yet — happy to add them once the feature is enabled on a staging instance so the captures show the live UI.
  • Customer-confidentiality check: no customer names, no Pylon ticket IDs, no Slack references. The two lightdash/lightdash references above are public issues/PRs.

Test plan

  • docs.json parses as valid JSON
  • All /references/... links in the new page resolve to existing pages
  • Reviewer: spot-check the page rendering in Mintlify preview, especially the <Info>, <Note>, and <Warning> callouts
  • Reviewer: confirm placement under Admin feels right vs. promoting Leave higher in the nav (any-member action vs. admin-only grouping)

🤖 Generated with Claude Code

New reference page covering the Danger zone in General settings: how
to leave an organization (any member, behind a feature flag while
rolling out), how to delete an organization (admin only), and the
"at least one admin" constraint that mirrors the SCIM rule. Also
adds a callout to the invite-new-users page explaining the cross-org
invite error and the recovery flow, since admins will hit that error
when trying to invite a user who already belongs to another org.

Refs lightdash/lightdash#22211
Pairs with lightdash/lightdash#22915

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Drop the "what gets removed / what stays" implementation detail,
the redundant "you'll be signed out" line, and the cross-org invite
note (already covered in invite-new-users).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Page now assumes the feature is available to all readers.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 12, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 12, 2026, 7:57 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Reverts the earlier addition — the callout isn't needed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Drop the UI-state implementation note and the SCIM cross-link.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Paragraph reads fine inline under Leaving an organization.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

🤖 Documentation Bot

All checks passed! No issues found.

@charliedowler charliedowler merged commit 0d61465 into main May 12, 2026
4 of 5 checks passed
@charliedowler charliedowler deleted the leave-org branch May 12, 2026 16:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant