[docs-scanner] Misleading SCIM guidance in team member removal section
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:
- Sign in to Docker Home and select your organization.
- Select Teams, then choose the name of the team member you want to remove.
- 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:
- Whether the SCIM guidance applies to removing from teams or from the organization
- What happens when you remove someone from the IdP (do they get removed from all teams? from the organization?)
- 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:
- 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
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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