Skip to content

Prefer pyproject README metadata#2052

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

Prefer pyproject README metadata#2052
Herrtian wants to merge 1 commit into
pypa:mainfrom
Herrtian:prefer-pyproject-readme

Conversation

@Herrtian
Copy link
Copy Markdown
Contributor

@Herrtian Herrtian commented May 19, 2026

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/

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.

Packaging instructions are not optimal about README.MD

1 participant