Author chris.jerdonek
Recipients chris.jerdonek, eric.araujo, ezio.melotti, georg.brandl, tarek
Date 2012-11-04.19:03:11
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1352055793.2.0.149261948913.issue16406@psf.upfronthosting.co.za>
In-reply-to
Content
I think the Package Index (PyPI) documentation would be clearer if the section called "Uploading Packages to the Package Index":

http://docs.python.org/3.4/distutils/uploading.html

were made a part of the previous section about PyPI (now called "Registering with the Package Index"):

http://docs.python.org/3.4/distutils/packageindex.html

The combined section could then be renamed simply to "The Python Package Index (PyPI)".

Both sections are small and very closely related.  For example, the second half of the section on uploading (the subsection called "PyPI package display") is not actually about uploading but rather about registering and PyPI in general.  Similarly, the second half of the first section on registering (the subsection called "The .pypirc file") applies equally to uploading as it does to registering.

I was affected by the current organization, for example, because it gave the impression that uploading updates the PyPI package display (which is conceivable since PKG-INFO is part of the uploaded files).  Rather, it is registering a version which updates the package display for that version.

A combined section on PyPI would better reflect how things should be understood.
History
Date User Action Args
2012-11-04 19:03:13chris.jerdoneksetrecipients: + chris.jerdonek, georg.brandl, tarek, ezio.melotti, eric.araujo
2012-11-04 19:03:13chris.jerdoneksetmessageid: <1352055793.2.0.149261948913.issue16406@psf.upfronthosting.co.za>
2012-11-04 19:03:12chris.jerdoneklinkissue16406 messages
2012-11-04 19:03:11chris.jerdonekcreate