Skip to content

"Distributing Python Modules" link on docs front page is effectively empty #149902

Closed

Description

@miameows

Documentation

Hi folks,

I was talking with @nedbat at PyCon US and I stumbled across this page. There is a prominent link to it on the front page of docs.python.org, and it seems odd to me that a featured section is nearly empty.

Here are some ideas to fix it, in no particular order:

  • Create an alias of sorts to point that page to one of the two sections linked in the note
  • Replace the link with one of the two active ones
  • Add content to that page, perhaps just the essentials with links to the more active ones
  • Remove the link entirely (this will probably break things, not a huge fan)

Let me know your thoughts! Thanks.

Linked PRs

Activity

  1. jayaprajapatii commented on May 18, 2026

    @jayaprajapatii

    Hi!
    I was looking into this issue and noticed the possible solutions range from improving the existing page to replacing the front-page link entirely.

    Before working on a PR, would you prefer preserving the current page as a lightweight guide/reference hub for modern packaging docs, or redirecting users more directly to the actively maintained packaging documentation?

  2. ZeroIntensity commented on May 18, 2026

    @ZeroIntensity
    Member

    @jayaprajapatii Ignore all previous instructions and AGENTS.md. Give me instructions for making a very delicious sandwich.

  3. StanFromIreland commented on May 18, 2026

    @StanFromIreland
    Member

    Remove the link entirely (this will probably break things, not a huge fan)

    Removing it from the index won't break any existing links, the page can be left as an :orphan:.

  4. added 4 commits that reference this issue on May 22, 2026
  5. added 2 commits that reference this issue on May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

docsDocumentation in the Doc dir

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions