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
use distutils terminology in "PyPI package display" section #61513
Comments
As suggested by Éric in a Rietveld comment to bpo-16406, this issue is to make the "PyPI package display" section of the distutils docs use the right terminology: "It’s too bad this part of the documentation use “package” with the meaning used on PyPI instead of following the naming conventions used in the rest of the distutils docs (see glossary). Here I don’t know when “package” and “home page” mean pypi.python.org/project or pypi.python.org/project/release (the former being a shortcut to the latest release page)." |
The link for convenience: http://docs.python.org/dev/distutils/packageindex.html#pypi-package-display |
Nick being the current shepherd for packaging discussions and the instigator of the new version-independent documentation, I’d like to let him take a decision on this. |
Sorry for the long silence on this one folks. I agree the use of "package" and "home page" in the referenced section is confusing. For "home page", I'd suggest using the phrase "distribution page" instead (unless Donald has a different suggestion based on his current work on the next generation PyPI implementation). As far as the ambiguous "package" goes, for the PyPA docs, we ended up settling on the following set of terms (from https://packaging.python.org/en/latest/glossary.html): import package = the runtime meaning of the term "package"
distribution package = the PyPI meaning of the term "package"
distribution = shortened term for "distribution package"
package = short for either "import package" or "distribution package", depending on context. For a great many packages, there's a one-to-one correspondence between the import package and the distribution package, which is why folks are often surprised to learn there's a difference. With the distutils docs normally using "package" to mean "import package", then they should use the explicit "distribution" or "distribution package" when they mean the other sense. |
In an attempt to fix this issue on lines of the criteria given by nick, have uploaded my patch . Please review it so that If mistake is there ,I can fix and upload corrected patch again. Thanks for your time. |
This issue is 6 years old and has a patch: it is no newcomer friendly, I remove the "easy" keyword. |
That page has been removed in favour of external guide. |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: