Social problems of Python doc [was Re: Python docs disappointing]
Wed Aug 12 03:51:03 CEST 2009
Carl Banks <pavlovevidence at gmail.com> writes:
> On> For example, kj (who started this mess of thread) complained that
> pydoc didn't give exhaustive usage documentation. In contrast, I
> think pydoc gives too much information. I would rather have only the
> bare minimum; I don't want to pan through ten paragraphs just to see
> what the fifth argument is.
The problem is that it doesn't sufficiently separate the carefully
written useful stuff from the automatically generated useless stuff.
More information about the Python-list