Skip to content

Discourage deletion, encourage yanking in "sure you want to delete this?" message/FAQ #8674

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
brainwane opened this issue Oct 8, 2020 · 0 comments · Fixed by #8857
Closed
Labels
documentation HTML requires change to HTML files

Comments

@brainwane
Copy link
Contributor

What's the problem this feature will solve?
We've added the ability to yank releases, but some project owners/maintainers are still deleting releases when yanking would be more appropriate, as seems to have happened in jotes/django-cookies-samesite#40 with django-cookies-samesite pulling their 0.6.6 release. The current warning may not be dire enough:

pypi-package-deletion-guidance

Delete release 1.0.6.dev1?
This action cannot be undone!
You will not be able to re-upload a new distribution of the same type with the same version number. Consider yanking this release, making a new release or a post release instead.

Describe the solution you'd like
@timabbott suggested we strengthen the warning, "helping maintainers realize it's going to be a mistake before they do it by just documenting clearly what the impact is." @andersk suggested:

I think it might be helpful to add something like “Deletion will break any downstream projects relying on a pinned version of this package. It is intended as a last resort for legal issues or malware infection.”

I'm open to better, more concise wording. We could (in addition, or instead of this) link the word "yanking" to the FAQ entry and add more details and encouragement to that FAQ entry.

Additional context
Followup to #5837 and possibly related to #6091.

@brainwane brainwane added documentation HTML requires change to HTML files labels Oct 8, 2020
@di di closed this as completed in #8857 Nov 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation HTML requires change to HTML files
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant