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.
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.
Zope3-dev mailing list