python / devguide

The Python developer's guide
https://devguide.python.org/
Creative Commons Zero v1.0 Universal
1.88k stars 786 forks source link

Smoother terminology: commit, pull request, patch, changeset #1443

Closed nedbat closed 1 month ago

nedbat commented 1 month ago

Describe the bug

These four terms are used in the devguide. We should make the terminology uniform, and based on git/GitHub usage.

ezio-melotti commented 1 month ago

"changset" was the official term used in the Mercurial days, and it should be fine to get rid of those since Git uses the term "commit" instead. In some contexts, "patch" was used to refer to the actual .diff files that we used to attach to the b.p.o issues before we moved to GitHub and started using PRs, and in those instances it can be replaced with the terms you suggested. The change log initially used the term to refer to the .diff files, but since "patch" is also a more generic concept[^1], it still works.

[^1]: e.g. in a sentence like "The vulnerability was patched by merging Josephine Koder's PR."

nedbat commented 1 month ago

PR: #1446