[Distutils] Another conversation starter - pip documentation in the Python docs

[Donald Stufft]

On Jul 14, 2013, at 5:29 PM, Marcus Smith <qwcode at gmail.com> wrote:

> no reason not to change "Package" to "Distribution" now, right? 
> this (http://docs.python.org/2/install/index.html) already uses the "Distribution" word.
> which means changing sentences like  "There are currently 32660 packages here." to "There are currently 32660 distributions here."
> and the main table listing would use the word "Distribution"
> 
> 

That's 32600 projects, There are almost 200k distributions. And the main table listing would be "Releases" or "Project Releases".

> On Sun, Jul 14, 2013 at 2:24 PM, Donald Stufft <donald at stufft.io> wrote:
> 
> On Jul 14, 2013, at 5:22 PM, Marcus Smith <qwcode at gmail.com> wrote:
> 
>> Donald:
>> thoughts on changing our use of "Package" on pypi to "Distribution"? (except for the title of course)
>> If we're not going to do that, we should explain and bless the double use of "Package" and drop using "Distribution" in any docs.
>> Our fundamental concepts shouldn't be confusing and conflicted.
>> 
>> On Sun, Jul 14, 2013 at 1:05 PM, Marcus Smith <qwcode at gmail.com> wrote:
>> 
>> BTW, I'm sick and tired of agonising every time I use the word "package" over whether I should be "correct" and use "distribution". Can the guide just come right out and bless the occasionally-ambiguous but commonly-used dual nature of the word "package"? If not, can people start actually *using* "distribution" consistently for what pip downloads and installs, so I can find a few more examples for me to copy when I end up with awkward phrases like "distributing your distribution"...? (You'd never believe English was my native language, would you? :-))
>> 
>> I hear you.  I feel the same agony.  It think we should use the word "Distribution", but it's hard to compete when PyPI uses "Package".
>> Nick, what do we do?   :  )
>> 
>> Marcus
>> 
>> 
>> _______________________________________________
>> Distutils-SIG maillist  -  Distutils-SIG at python.org
>> http://mail.python.org/mailman/listinfo/distutils-sig
> 
> PyPI will eventually move to using the definitions as defined in PEP426 http://www.python.org/dev/peps/pep-0426/#supporting-definitions .
> 
> -----------------
> Donald Stufft
> PGP: 0x6E3CBCE93372DCFA // 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA
> 
> 


-----------------
Donald Stufft
PGP: 0x6E3CBCE93372DCFA // 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20130714/52d33fee/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 841 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20130714/52d33fee/attachment.pgp>