docs(orgs-and-teams): document collaborators and SSO as mutually exclusive [EDU-1513] - #1829
Merged
Merged
Conversation
…EDU-26] Adding a workspace participant by username or email can create both an organization membership and a workspace participant record, and the two usage limits that govern them are checked at different points. Neither doc set explained this, so the members-per-organization limit appeared to be hit for no reason. Document what each starting state produces, which limit applies when, and who gets notified. Clarify that having a Seqera account is not the same as belonging to the organization, which is the distinction that determines whether a member seat is consumed. Add the participant troubleshooting messages, the default Launch role, and the collaborator lifecycle in the Collaborators section. For Enterprise, document TOWER_PARTICIPANT_AUTO_CREATE_USER and TOWER_MEMBER_AUTO_CREATE_USER, including that accounts created on add are marked as trusted regardless of the trusted email configuration. Also fix the Collaborators cross-link, which pointed at workspace creation rather than participant addition, and drop a stray code fence in the Cloud page. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…usive [EDU-1513] Collaborators authenticate outside the organization's identity provider, so the platform blocks the combination in both directions: a new collaborator cannot be added while SSO is active, and SSO cannot be configured while any collaborators exist. Neither doc set said so, and the remediation for the second case is not obvious. Add a Collaborators and SSO subsection and the corresponding participant error message. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
christopher-hakkaart
approved these changes
Sep 8, 2026
christopher-hakkaart
left a comment
christopher-hakkaart
left a comment
Member
There was a problem hiding this comment.
Minor editorial suggestion.
Co-authored-by: Chris Hakkaart <chris.hakkaart@seqera.io> Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
justinegeffen
requested review from
andrew-dawson-seqera
and removed request for
MichaelTansiniSeqera
September 10, 2026 13:46
justinegeffen
added
do not merge
Base automatically changed from
docs/EDU-26-participant-creation-logic
to
master
September 14, 2026 17:12
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
❌ Deploy Preview for seqera-docs failed. Why did it fail? →
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Collaborators authenticate outside an organization's identity provider, so the platform blocks the combination in both directions. Neither doc set said so, and the remediation for the second case is not obvious from the error alone.
Adds a Collaborators and SSO subsection to the Collaborators section, and the corresponding message to the participant error table.
Scope
Cloud, Enterprise, and the
version-26.1Enterprise snapshot. The Cloud page links to the single sign-on page; Enterprise has no equivalent organization-level SSO page to link to, so the term is left unlinked there.Stacked PR
Based on the branch for #1828, which introduces the Collaborators content and the error table this builds on. Please review and merge that one first — this will retarget to
masterautomatically.Verification
Both directions of the guard were confirmed against the backend source, including the exact error message and the condition under which it fires.
docusaurus buildpasses with no broken links. Vale reports 0 errors on the changed pages.🤖 Generated with Claude Code