Skip to content

[docs-scanner] Incomplete team creation instructions in manage-a-team.md #24915

@docker-agent

Description

@docker-agent

File: content/manuals/admin/organization/manage/manage-a-team.md

Issue

The "Create a team" section provides incomplete instructions that leave users without guidance on how to actually create a team:

Create a team

  1. Sign in to Docker Home and select your
    organization.
  2. Select Teams.

The instructions stop after navigating to the Teams page, with no explanation of what to do next (e.g., clicking a "Create team" button, entering a team name, etc.).

Why this matters

This incomplete section creates multiple problems:

  1. Self-referential loop: Later in the same document, the "Set team repository permissions" section states:

    "You must create a team before you are able to configure repository permissions. For more details, see Create and manage a team."

    This links back to the same page where the instructions are incomplete, creating a circular reference that doesn't help users.

  2. Broken external references: Other documentation pages link to this page for team creation instructions (e.g., content/manuals/docker-hub/repos/manage/access.md), meaning users arriving from multiple entry points will encounter this incomplete guidance.

  3. User confusion: Users following these instructions will reach the Teams page and not know what action to take next to actually create a team.

Suggested fix

Complete the "Create a team" section with the remaining steps. Based on typical UI patterns, this likely needs steps such as:

  1. Sign in to Docker Home and select your organization.
  2. Select Teams.
  3. Select Create team (or similar button).
  4. Enter a team name and optional description.
  5. Select Create to confirm.

The exact steps should match the current Docker Home UI flow for team creation.


Found by nightly documentation quality 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