Skip to content

[docs-scanner] Self-referencing link in team repository permissions section #25923

Description

@docker-agent

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

Issue

The "Set team repository permissions" section contains a self-referencing link that suggests readers should go elsewhere for details, when the information is already on the same page:

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

This link points to the same page the reader is already on (manage-a-team.md), creating a circular reference.

Why this matters

A reader following this documentation would click the "Create and manage a team" link expecting to find more details about creating a team, only to be taken back to the same page they're already reading. This creates confusion and wastes the reader's time. The "Create a team" section is actually just a few lines above this reference on the same page.

Suggested fix

Choose one of these approaches:

  1. Remove the sentence entirely since the prerequisite is clear and the "Create a team" section is immediately above:

    You must create a team before you are able to configure repository permissions.
    
    To set team repository permissions:
  2. Use an internal anchor link to point to the section on the same page:

    You must create a team before you are able to configure repository permissions.
    For more details, see [Create a team](#create-a-team).
  3. Reword to reference the previous section without a link:

    You must create a team first using the steps in the previous section before you can configure repository permissions.

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions