Skip to content

Conversation

abravalheri
Copy link
Contributor

@abravalheri abravalheri commented May 30, 2025

This PR is motivated by the discussion in https://discuss.python.org/t/how-can-build-backends-avoid-breaking-users-when-they-make-backwards-incompatible-changes/85847.

The core idea is to provide advice for people with mission critic systems/pipelines or environments with very little tolerance for unforeseen (and sometimes accidental) disruptions when building packages.

@webknjaz webknjaz added component: guides diataxis: explanation Understanding oriented discussion (https://diataxis.fr/explanation/) labels May 31, 2025
@abravalheri abravalheri force-pushed the sdist-drawbacks-and-reproducibility branch from d04a44e to ba40141 Compare May 31, 2025 11:09
@abravalheri abravalheri force-pushed the sdist-drawbacks-and-reproducibility branch from 085d5a8 to ac655bd Compare May 31, 2025 11:18
@abravalheri
Copy link
Contributor Author

abravalheri commented May 31, 2025

It seems that the linkcheck is broken, but in a file that is not affected by this PR?

(guides/installing-using-linux-tools: line   88) broken    https://developers.redhat.com/products/softwarecollections/overview - 403 Client Error: Forbidden for url: https://developers.redhat.com/products/softwarecollections/overview

I am also able to access the URL from the browser:

image

so possibly that is just a hiccup?

@ncoghlan
Copy link
Member

Rather than framing this as a guide on the disadvantages of sdists, I'd prefer to see this framed topic as a guide on the advantages of publishing wheel archives in addition to publishing sdists.

sdists and wheels serve different purposes, so "publish both" is the only option that covers the full range of potential use cases (source control links don't provide assurance that the tag hasn't been moved since the release was made).

The packaging tutorial does suggest to publish both, but it would be good to have something to link to that explained why that is the recommendation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component: guides diataxis: explanation Understanding oriented discussion (https://diataxis.fr/explanation/)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants