Skip to content

Add organization key concepts and a Configuring Organizations page - #938

Merged
jpshackelford merged 6 commits into
mainfrom
org-concepts-and-enterprise-setup
Oct 15, 2026
Merged

jpshackelford merged 6 commits into
mainfrom
org-concepts-and-enterprise-setup

Conversation

@jpshackelford

@jpshackelford jpshackelford commented Oct 13, 2026 •

Copy link
Copy Markdown
Member
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

The Organizations overview never explained what a personal organization, a team organization, the current organization, a super admin, or the default organization is, and it told every reader to "create a new organization from the OpenHands Cloud dashboard", which is not possible on OpenHands Enterprise, where only a super admin can create one. The VM install Admin Console page lists the default-organization and OEM user-creation options in one line each, and no page explains the Helm userProvisioning.enabled value.

This adds a "Key Concepts" section to the overview, with Enterprise-only parts marked, and fixes Getting Started step 2. It also adds a "Configuring Organizations" page, placed after the overview, with the settings for VM installs (Admin Console) and Kubernetes installs (Helm env values), their defaults, what each default-organization setting does, how hiding personal workspaces behaves, what user provisioning registers, and a four-step path for moving an existing installation to organizations without disruption. The admin console page now links to it from the Default OpenHands Organization section and the Enable OEM User Creation Flow row.

Behavior described on the new page was checked against the OpenHands/enterprise server and frontend code and the OpenHands-Cloud Replicated config and Helm chart. mint broken-links reports no broken links. The page has not been viewed rendered yet, so the second checkbox is open until the Mintlify preview has been reviewed.

This PR was drafted by an AI agent on behalf of the user.

Co-authored-by: openhands <openhands@all-hands.dev>
@mintlify

mintlify Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

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

Project Status Preview Updated
all-hands-ai 🟢 Ready View Preview Oct 15, 2026, 1:46 PM

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

…ganizations page

Co-authored-by: openhands <openhands@all-hands.dev>
…ations and trim overlap

Co-authored-by: openhands <openhands@all-hands.dev>
@jpshackelford jpshackelford changed the title Add organization key concepts and an Enterprise organizations page Add organization key concepts and a Configuring Organizations page Oct 13, 2026
…ings

Co-authored-by: openhands <openhands@all-hands.dev>
… tabs

Co-authored-by: openhands <openhands@all-hands.dev>

@rajshah4 rajshah4 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for doing this, i need to work through this in the app to test it all out myself.
Reading through this, i did see we used "personal organizations" and we have "personal workspaces". Not sure if this is the place, but getting that standardized would be nice -- assuming they cover the same concept.

Co-authored-by: openhands <openhands@all-hands.dev>
@jpshackelford

Copy link
Copy Markdown
Member Author

@rajshah4 Thanks, good catch. They are the same concept, so I standardized on personal workspace in edaecd2. The Key Concepts heading is now "Personal Workspaces and Team Organizations", and the body text and the "Default Organization" paragraph use the same term. The Hide Personal Workspaces setting name already matched. A team organization is still called an organization.

I did not change event-automations.mdx, which says "personal org", or the cookbook/ pages, which are generated from OpenHands/enterprise-cookbook. I'll follow up on those separately.

This comment was created by an AI agent (OpenHands) on behalf of jpshackelford.

@jpshackelford
jpshackelford merged commit 240b98f into main Oct 15, 2026
5 checks passed
@jpshackelford
jpshackelford deleted the org-concepts-and-enterprise-setup branch October 15, 2026 13:48

This branch was successfully deployed

1 active deployment
staging — edaecd2c Deployed Oct 15, 2026 by mintlify[bot]
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.

3 participants