docker / docker/docs

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

Open Beginner friendly
#26,042 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Markdown
Stars
4.7k
Forks
8.5k
Avg merge
2d 18h
Merged PRs (30d)
108

Description

File: content/manuals/accounts/organization/manage/members.md

Issue

The "Remove members from teams" section begins with guidance about SCIM that doesn't match the procedure that follows:

If your organization uses single sign-on (SSO) with SCIM enabled, you should remove members from your identity provider (IdP). This automatically removes members from Docker. If SCIM is disabled, follow procedures in this doc to remove members manually in Docker.

However, the procedure that follows only shows how to remove a member from a specific team, not from the organization entirely:

  1. Sign in to Docker Home and select your organization.
  2. Select Teams, then choose the name of the team member you want to remove.
  3. Select the X next to the user's name to remove them from the team.
Why this matters

Readers following the SCIM guidance expect to learn how removing members from their IdP affects the organization, but the procedure only covers team membership. This creates confusion about:

  1. Whether the SCIM guidance applies to removing from teams or from the organization
  2. What happens when you remove someone from the IdP (do they get removed from all teams? from the organization?)
  3. Where to find the actual procedure for removing members from the organization when SCIM is disabled

The section title says "Remove members from teams" but the intro talks about removing members from the organization via IdP.

Suggested fix

Either:

  1. Move the SCIM guidance to a separate section about removing members from the organization (not just teams), and keep this section focused only on team membership removal
  2. Or clarify in the intro that the SCIM guidance is about organization-level removal (and link to where that's documented), while this section specifically covers removing from teams only

The SCIM guidance and the procedure should match in scope - both about teams, or both about organization membership.


Found by nightly documentation quality scanner

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open content/manuals/accounts/organization/manage/members.md and read the “Remove members from teams” section alongside its SCIM introduction. Decide whether to separate or clarify the organization-level guidance, keeping the procedure’s scope consistent with the introduction and linking the organization-removal procedure if needed. Done means readers can distinguish team removal from organization removal and the documentation quality issue is resolved.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.