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
- Sign in to Docker Home and select your
organization.
- 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:
-
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.
-
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.
-
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:
- Sign in to Docker Home and select your organization.
- Select Teams.
- Select Create team (or similar button).
- Enter a team name and optional description.
- Select Create to confirm.
The exact steps should match the current Docker Home UI flow for team creation.
Found by nightly documentation quality scanner
File:
content/manuals/admin/organization/manage/manage-a-team.mdIssue
The "Create a team" section provides incomplete instructions that leave users without guidance on how to actually create a team:
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:
Self-referential loop: Later in the same document, the "Set team repository permissions" section states:
This links back to the same page where the instructions are incomplete, creating a circular reference that doesn't help users.
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.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:
The exact steps should match the current Docker Home UI flow for team creation.
Found by nightly documentation quality scanner