Skip to content

Update README metadata guidance#2071

Open
Himanshuagrawal4 wants to merge 1 commit into
pypa:mainfrom
Himanshuagrawal4:PRO/packaging-readme-guidance
Open

Update README metadata guidance#2071
Himanshuagrawal4 wants to merge 1 commit into
pypa:mainfrom
Himanshuagrawal4:PRO/packaging-readme-guidance

Conversation

@Himanshuagrawal4

@Himanshuagrawal4 Himanshuagrawal4 commented Jun 13, 2026

Copy link
Copy Markdown

Summary

  • recommend the pyproject.toml [project] readme field first
  • keep the older setup.py long_description guidance for projects that still need it
  • note that the referenced README should be present in the source distribution

Why

The README guide still led with older setup.py metadata. This updates the main path for modern projects while preserving the legacy example.

Validation

  • sphinx-build --color --keep-going -j auto -b html -n -W source build
  • git diff --check

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

@Himanshuagrawal4 Himanshuagrawal4 marked this pull request as ready for review June 13, 2026 20:24
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.

1 participant