Skip to content

[docs-scanner] Content duplication between company/users.md and organization/members.md creates drift risk #24250

@docker-agent

Description

@docker-agent

File: content/manuals/admin/company/users.md

Issue

The file users.md duplicates substantial content from organization/members.md, including:

  • The entire "Invite members via Docker ID or email address" section
  • The entire "Invite members via CSV file" section
  • The "Resend invitations" section
  • The "Invite members via API" section

The duplication is nearly word-for-word but with minor variations (e.g., navigation paths differ slightly). This creates a maintenance burden and drift risk - when one file is updated, the other may not be, leading to inconsistent information.

At the end, users.md references the organization members page:

Use Docker Hub to add a member to a team or remove a member from a team. For more details, see Manage members.

This suggests the content should be consolidated rather than duplicated.

Suggested fix

Refactor to eliminate duplication:

  1. Keep the detailed invitation procedures in organization/members.md (the canonical source)
  2. In company/users.md, provide a brief overview of member management at the company level with clear links to the detailed procedures in the organization members page
  3. Only include company-specific differences in users.md (if any exist)

This follows the DRY principle and ensures users get consistent, up-to-date information from a single source.


Found by nightly documentation freshness scanner

Metadata

Metadata

Assignees

Labels

area/adminRelates to Docker Admin

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions