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

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions