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

Add changelogs to all standards #1203

Closed
encukou opened this issue Feb 3, 2023 · 2 comments · Fixed by #1464
Closed

Add changelogs to all standards #1203

encukou opened this issue Feb 3, 2023 · 2 comments · Fixed by #1464
Assignees

Comments

@encukou
Copy link
Contributor

encukou commented Feb 3, 2023

It would be good to add a “History” section to all PyPA specifications, like the one in direct-url.
Even with a single entry, the section is useful -- to set expectations for future updates.
Please add dates if the spec isn't versioned in another way.
See discussion on Discourse.

@pfmoore
Copy link
Member

pfmoore commented Feb 3, 2023

For anyone interested in this, the biggest part is likely to be the research to find dates when decisions happened and changes were made, and links to the appropriate posts recording the decisions. For newer specifications, the information will likely be in the packaging category on Discourse but for the older ones, you'll probably need to dig around in the distutils-sig archives. Github history of the spec page itself is likely a good starting point for getting dates to guide the search.

@jeanas
Copy link
Contributor

jeanas commented Dec 22, 2023

I agree that dates throughout would be useful, since they may be relevant to users when they wonder how recent the tool must be to support feature X or Y.

IMHO, we don't need the PEP approval messages because they're already recorded on the PEP's page (or should be); OTOH, links to discussions other than PEPs are useful.

jeanas added a commit to jeanas/packaging.python.org that referenced this issue Dec 22, 2023
jeanas added a commit to jeanas/packaging.python.org that referenced this issue Dec 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants