[Distutils] Best practices for creating eggs?

[Kevin Dangoor]

On Jun 29, 2006, at 5:37 AM, Paul Moore wrote:

> On 6/28/06, Phillip J. Eby <pje at telecommunity.com> wrote:
>> I assume that most people will read the docs on the web, and that  
>> if they
>> want the documentation source, they will download the "sdist"  
>> distribution
>> that I always upload alongside of the eggs.
>
> I work offline sufficiently often that not having local documentation
> is frustrating. There's no standard for local docs, which is a
> nuisance, and makes for an inconsistent story between different
> packages, but I'd be concerned if setuptools made it more difficult to
> bundle local docs.

I'll second this (or is it third, since Jim was asking something  
similar)? Being able to get at a package's documentation after it's  
installed would be nice.

If you use docstrings, at least you can use help() and pydoc for  
apidocs.

Kevin