Skip to content

[docs-scanner] Misleading title: 'Manage company members' when members belong to organizations #24893

@docker-agent

Description

@docker-agent

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

Issue

The page title and description use the term "company members," but there is no such thing as a direct company member in Docker's architecture. Users are members of organizations, and companies contain organizations.

From the page:

Title: "Manage company members"
Description: "Learn how to manage company members in the Docker Admin Console."

However, the actual content describes inviting members to organizations within a company:

"On the Organizations page, select the organization you want to invite members to."

This is confirmed by the company owners documentation, which states:

"Company owners do not occupy a seat unless they are added as a member of an organization under your company"

Why this matters

The title "Manage company members" misleads readers into thinking there's a company-level membership concept, when in reality all membership happens at the organization level. A company owner trying to understand how to manage users would be confused about whether they're managing company-level or organization-level members.

Suggested fix

Update the title and description to clarify this is about managing organization members from the company admin level:

  • Title: "Manage organization members" or "Manage members across organizations"
  • Description: "Learn how to manage members in your company's organizations using the Docker Admin Console."

This accurately reflects that the page helps company owners manage members of the organizations within their company.


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