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:
-
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:
-
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).
-
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
File:
content/manuals/admin/organization/manage/manage-a-team.mdIssue
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:
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:
Remove the sentence entirely since the prerequisite is clear and the "Create a team" section is immediately above:
Use an internal anchor link to point to the section on the same page:
Reword to reference the previous section without a link:
Found by nightly documentation quality scanner