On Jun 29, 2006, at 5:37 AM, Paul Moore wrote:
On 6/28/06, Phillip J. Eby email@example.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.