Skip to content

Add docs about how to improve predictability when installing sdists#5168

Merged
abravalheri merged 5 commits intopypa:mainfrom
abravalheri:docs/reproducible-builds
Feb 9, 2026
Merged

Add docs about how to improve predictability when installing sdists#5168
abravalheri merged 5 commits intopypa:mainfrom
abravalheri:docs/reproducible-builds

Conversation

@abravalheri
Copy link
Copy Markdown
Contributor

Summary of changes

This PR ports content initially proposed for PyPUG: pypa/packaging.python.org#1867.

PyPUG reviewers expressed interest in guidance that explains why publishers should release wheels alongside sdists, supporting the "publish both" recommendation.

The text here is instead intended to support end‑users who need to install packages that are only available as sdists.

I believe that the text is still "good-to-have" especially to aid users that need to install older packages whose build depends on deprecated or removed Setuptools features.

Closes

Pull Request Checklist

@abravalheri abravalheri changed the title Add docs about how to improve predictability when using sdists Add docs about how to improve predictability when installing sdists Jan 28, 2026
@abravalheri abravalheri marked this pull request as ready for review January 28, 2026 13:00
@abravalheri
Copy link
Copy Markdown
Contributor Author

abravalheri commented Feb 5, 2026

I am tempted to publish this document, because it can be very relevant for indirect setuptools users...

@notatallshaw, do you have any thoughts? (if you have the time to have a look...)

@abravalheri abravalheri merged commit 4966178 into pypa:main Feb 9, 2026
25 checks passed
@abravalheri abravalheri deleted the docs/reproducible-builds branch February 9, 2026 16:59
@abravalheri
Copy link
Copy Markdown
Contributor Author

I am merging this now as I believe it contains important information.
The exact test can be revisited in follow up PRs and everyone is welcome to contribute.

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