-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
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:
- Keep the detailed invitation procedures in
organization/members.md(the canonical source) - 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 - 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