Skip to content

[docs-scanner] Abrupt context shift to team management without explanation #24894

@docker-agent

Description

@docker-agent

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

Issue

The page ends with an abrupt section about team management that redirects to organization-level documentation without explaining the context or relationship:

Manage members on a team

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

This appears at the end of a page about inviting members to organizations from the company admin console. The transition provides no explanation of:

  1. Why team management is mentioned on a company-level user management page
  2. Why it redirects to organization-level documentation instead of providing company-level instructions
  3. What the relationship is between inviting organization members and managing teams

Why this matters

A company owner following this page would be confused by the sudden shift in context. They've been learning how to invite members to organizations from the company level, and then without explanation they're told to "use Docker Hub" and redirected to organization-level documentation for team operations. This leaves them wondering:

  • Should they switch from the Admin Console to Docker Hub?
  • Is team management not available at the company level?
  • How does this relate to what they just learned?

Suggested fix

Either:

  1. Remove this section entirely if team management isn't relevant to company-level user management, or
  2. Add context explaining the relationship:
## Manage members on a team

After inviting members to an organization, you can add them to teams within that organization. Teams exist at the organization level, not the company level.

To add or remove members from teams, switch to the organization view. For details, see [Manage members on a team](../../organization/manage/members.md#manage-members-on-a-team).

This explains why the user is being redirected and clarifies the organizational hierarchy.


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions