gh-149902: Remove dead packaging docs link and add a new secition for external resources#150030
gh-149902: Remove dead packaging docs link and add a new secition for external resources#150030miameows wants to merge 6 commits into
Conversation
Documentation build overview
8 files changed ·
|
| </td></tr> | ||
| </table> | ||
|
|
||
| <p><strong>{% trans %}Other resources:{% endtrans %}</strong></p> |
There was a problem hiding this comment.
With this we'll have two "Other resources" sections, one in the sidebar and one here, why not add these to the existing one?
There was a problem hiding this comment.
The "Other resources" section also has two links to the deprecated Python wiki, maybe we should drop those and link to packaging.python.org and typing.python.org instead.
There was a problem hiding this comment.
Do we need both "Other resources" sections?
If yes, should they both contain the same things?
If not, which shall we remlve?
Perhaps the wiki books link could be replaced with
https://www.pythondiscord.com/resources/?type=book or https://pythonbooks.org/ ?
See also #148998 for more general wiki cleanup.
There was a problem hiding this comment.
I'm in favor of removing the other section if it links to outdated content
There was a problem hiding this comment.
I think the placement of this new section should be fairly prominent, considering it contains a link that was (indirectly) already featured front and center. I think it's helpful to have a "signpost" of sorts so users who do a web search for "Python documentation" can easily find related resources without having to look at the small text in the sidebar. I'm of the opinion that sidebars are for navigation of complex hierarchies, not holding content
Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Stan Ulbrych <stan@python.org>
Hi folks,
This PR removes a link to "Distributing Python Modules" from the front page of the docs. Said page was empty save for a message telling users to go to packaging.python.org. It was already marked as an orphan, so I removed the link and made a new section for "Other resources", linking packaging.python.org and (at the suggestion of Petr) typing.python.org.
I understand this is a fairly visible change and will probably require some discussion (and possibly modification) before it's ready to merge. I'm here to answer any questions or fix issues.
Before:

After:

cc @encukou (helped me plan this approach) and @nedbat (docs team)
Closes #149902
Thank you!