Summary section for archiving policy #28922
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
While it is precise and detailed, I found the new archiving policy a bit hard to read as a package maintainer when @jmid linked it on a recent package upload PR of mine. This patch adds a summary to the top which will hopefully be helpful to others who come across this policy for the first time.
I'm not proposing any changes to the policy itself: the summary is based on my understanding of the text below, and (I hope) doesn't contradict it anywhere, even if it doesn't spell out all details up front.
Maintenance note: the summary also includes the current compiler cutoff threshold, so if this PR is accepted there will be two locations in the document that need to be updated when the threshold changes.
cc @hannesm