Skip to content

docs: scope the SCIM note in the team removal section - #26054

Open
sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-scim-org-removal-scope
Open

docs: scope the SCIM note in the team removal section#26054
sunm2n wants to merge 1 commit into
docker:mainfrom
sunm2n:docs-scim-org-removal-scope

Conversation

@sunm2n

@sunm2n sunm2n commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Description

The "Remove members from teams" section opened with SCIM guidance written at
organization scope, then gave a procedure that only removes someone from a
team. It also told readers to "follow procedures in this doc" for manual
removal, which this page does not contain — the manual organization removal
procedure lives in
Remove users.

This scopes the SCIM note to organization membership, links to that procedure,
and leaves the section's own procedure clearly about team membership.

Two wording changes beyond the link:

  • The note said to remove members "from your identity provider (IdP)". The SCIM
    documentation describes the action more narrowly — removing the user from the
    Docker application in the IdP — so this matches that wording.
  • "removes members from Docker" is now "removes them from your Docker
    organization", since organization scope was the ambiguity being reported.

Related, not changed here: the SCIM page and the platform FAQ both point to
this page as the reference for organization removal
(security/provisioning/scim/_index.md, faqs/platform.md). With this change
readers who land here from either one can follow the link through. Happy to
adjust those references instead, or in addition, if you'd prefer they point
straight at the SSO page.

Verified: the linked procedure and its anchor exist in the current docs.

Related issues or tickets

Fixes #26042

Reviews

  • Technical review
  • Editorial review
  • Product review

The "Remove members from teams" section opened with SCIM guidance about
organization membership, then gave a procedure that only removes someone
from a team. It also pointed readers to "procedures in this doc" for manual
removal, which this page does not contain.

State the organization scope explicitly, describe the IdP action as removing
the user from the Docker application rather than from the IdP, and link to
the existing Remove users procedure for manual organization removal.

Fixes docker#26042

Signed-off-by: Sunmin Lee <134378502+sunm2n@users.noreply.github.com>
@sunm2n
sunm2n requested a review from akristen as a code owner September 10, 2026 05:13
@netlify

netlify Bot commented Sep 10, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit c823c19
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6aa23c7f0210950009dfcc0f
😎 Deploy Preview https://deploy-preview-26054--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/admin Relates to Docker Admin area/accounts Relates to Docker accounts labels Sep 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/accounts Relates to Docker accounts area/admin Relates to Docker Admin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-scanner] Misleading SCIM guidance in team member removal section

1 participant