Skip to content

docs: repoint two dead relref anchors into repositories.md - #11066

Open
simpleqt wants to merge 1 commit into
python-poetry:mainfrom
simpleqt:sq918/relref-anchors
Open

simpleqt wants to merge 1 commit into
python-poetry:mainfrom
simpleqt:sq918/relref-anchors

Conversation

@simpleqt

Copy link
Copy Markdown
Contributor

The anchors repositories#adding-a-repository (docs/libraries.md:131) and repositories#using-a-private-repository (docs/pyproject.md:801) no longer match any heading — they were orphaned when repositories.md was rewritten in #10941 (verified via git log -S and the heading list). Repointed at the existing #package-source-constraint and #private-repository-example sections, which cover the referenced content.

Both anchors (#adding-a-repository, #using-a-private-repository) were
orphaned when repositories.md was rewritten in python-poetry#10941; point at the
existing 'Package sources' and 'Private repository example' sections.
Copilot AI lite review requested due to automatic review settings September 17, 2026 16:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="docs/libraries.md" line_range="131" />
<code_context>

 In order to publish to a private repository, you will need to add it to your
-global list of repositories. See [Adding a repository]({{< relref "repositories#adding-a-repository" >}})
+global list of repositories. See [Package sources]({{< relref "repositories#package-source-constraint" >}})
 for more information.

</code_context>
<issue_to_address>
**issue:** The “Package sources” link lands on the “Package Source Constraint” subsection, which only explains restricting dependency resolution to a source; it does not explain adding a user-level publishing repository. Readers following the publishing instructions therefore still cannot find the required repository configuration.

**Triggers:** When a library author follows the link to configure a private publishing repository.

**Suggested fix:** Link to `repositories#publishable-repositories`, which documents configuring repositories used for publishing.

```suggestion
global list of repositories. See [Package sources]({{< relref "repositories#publishable-repositories" >}})
```
</issue_to_address>

Sourcery assessment

Approval pending. 1 finding to address first.

Blocking findings: docs/libraries.md:131


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Comment thread docs/libraries.md

In order to publish to a private repository, you will need to add it to your
global list of repositories. See [Adding a repository]({{< relref "repositories#adding-a-repository" >}})
global list of repositories. See [Package sources]({{< relref "repositories#package-source-constraint" >}})

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

issue: The “Package sources” link lands on the “Package Source Constraint” subsection, which only explains restricting dependency resolution to a source; it does not explain adding a user-level publishing repository. Readers following the publishing instructions therefore still cannot find the required repository configuration.

Triggers: When a library author follows the link to configure a private publishing repository.

Suggested fix: Link to repositories#publishable-repositories, which documents configuring repositories used for publishing.

Suggested change
global list of repositories. See [Package sources]({{< relref "repositories#package-source-constraint" >}})
global list of repositories. See [Package sources]({{< relref "repositories#publishable-repositories" >}})

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants