I have been following this approach with the long descriptions for my package descriptions and believe it it a consistent and meaningful way of communicating to a developer. It is not enough for me to see a couple of paragraphs. The doctest text inclusion gives me an immediate answer to what the package is about and how it works. I like what has been done very much and would like it to continue this way. Many thanks.

Regards,
David

Benji York wrote:
Christian Theune wrote:
 > Am Mittwoch, den 29.08.2007, 09:58 -0400 schrieb Fred Drake:
 >> I really don't like long PyPI pages myself; a few paragraphs seems
 >> sufficient, and is certainly more in line with the original intent of
 >> the "long description" field.

Since you asked: I like it (in absence of better project web pages).

 > IMHO This issue doesn't have to be dealt with for the initial stable
 > release. My highest interest is getting the stable software out of the
 > door in a timely manner. The more we add to the TODO list for each
 > package the longer it's going to take.

+1
_______________________________________________
Zope3-dev mailing list
Zope3-dev@zope.org
Unsub: http://mail.zope.org/mailman/options/zope3-dev/archive%40mail-archive.com

Reply via email to