Skip to content
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

Document the structure of our release number #12780

Merged
merged 1 commit into from
Jun 21, 2024
Merged

Conversation

pfmoore
Copy link
Member

@pfmoore pfmoore commented Jun 21, 2024

No description provided.

@pfmoore pfmoore added skip news Does not need a NEWS file entry (eg: trivial changes) type: docs Documentation related labels Jun 21, 2024
@pfmoore pfmoore merged commit 2753c77 into pypa:main Jun 21, 2024
13 of 14 checks passed
@pfmoore pfmoore deleted the rel_doc branch June 21, 2024 13:05
Comment on lines +22 to +23
and ``N`` identifies which release of the year (0=January, 1=April, 2=July, and
3=October).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pfmoore If I trust PyPI, pip 24.0 was released in February and pip 24.1 in June, which doesn't quite match what you've written here, so perhaps it would be better to be less specific ? 😁

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The releases are the ones quoted in the existing paragraph above. They are described using the intended month of release but yes, we do slip sometimes (rather more often than would be ideal, but we're highly limited in resources). The problem with being less specific is that if we decide to skip a release (for example, the July release, as we've only just released 24.1) people would get equally confused that we had 24.0, 24.1 and 24.3 but no 24.2.

This is a compromise, to get the idea across without being over-complicated.

Copy link
Member

@pradyunsg pradyunsg Jun 21, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be clearer to refer to them as quarters of the year?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That would work, yes.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How does #12783 look?

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jul 7, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
skip news Does not need a NEWS file entry (eg: trivial changes) type: docs Documentation related
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants