Skip to content

Add Documentation to project.urls - #221

Closed
Furox-Art wants to merge 1 commit into
jaraco:mainfrom
Furox-Art:docs-link-in-project-urls
Closed

Furox-Art wants to merge 1 commit into
jaraco:mainfrom
Furox-Art:docs-link-in-project-urls

Conversation

@Furox-Art

Copy link
Copy Markdown

Closes #52.

The README badge for the docs is opt-in per project - keyring and zipp
enable it, tempora does not - so the README is deliberately left alone here.
Adding the entry to [project.urls] is what puts a documentation link on the
PyPI page, which is where the reporter said they looked and found nothing.

It also flows into the rendered docs for free: docs/index.rst already renders
the project URLs via sidebar-links.

PROJECT_RTD is the same placeholder the README badge already uses, and it
resolves per project (in keyring it becomes keyring.readthedocs.io).

Adds newsfragments/52.feature.rst per the contributing guidance.

One trade-off worth flagging: a derived project with no Read the Docs build
would now publish a dead Documentation link on PyPI. Happy to make this
opt-in instead if you prefer - I did not find a # local marker convention for
[project.urls] that would allow a clean per-project override.

Closes #52. The readme badge for the docs is opt-in per project (keyring and zipp enable it, tempora does not), so the readme is left alone. Adding the entry here is what puts the link on the PyPI page, and it also flows into the rendered docs, whose sidebar already renders the project URLs via `sidebar-links`.

Adds newsfragments/52.feature.rst per the contributing guidance.
@Furox-Art Furox-Art closed this by deleting the head repository Oct 20, 2026
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.

Link to documentation

1 participant