Skip to content

Prefer pyproject README metadata - #2052

Closed
Herrtian wants to merge 1 commit into
pypa:mainfrom
Herrtian:prefer-pyproject-readme
Closed

Herrtian wants to merge 1 commit into
pypa:mainfrom
Herrtian:prefer-pyproject-readme

Conversation

@Herrtian

@Herrtian Herrtian commented May 19, 2026 •

Copy link
Copy Markdown
Contributor

Updates the README guide to prefer pyproject.toml's readme metadata and keeps the setup.py example as a legacy path with a note about including README files in sdists.

Closes #696.

Checks:

  • uv run --with pre-commit pre-commit run --files source/guides/making-a-pypi-friendly-readme.rst
  • uv run --with nox nox -s build

📚 Documentation preview 📚: https://python-packaging-user-guide--2052.org.readthedocs.build/en/2052/

@rgommers rgommers added component: guides type: maintenance Regular maintenance of the guide, CI and repo labels Nov 10, 2026
@rgommers

Copy link
Copy Markdown
Contributor

Thanks for the contribution. I'll close this as a duplicate though, because gh-2146 is a bit cleaner and already has approvals.

@rgommers rgommers closed this Nov 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component: guides type: maintenance Regular maintenance of the guide, CI and repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Packaging instructions are not optimal about README.MD

2 participants