Social problems of Python doc [was Re: Python docs disappointing]

greg greg at cosc.canterbury.ac.nz
Wed Aug 12 02:17:06 EDT 2009


rurpy at yahoo.com wrote:
> Such a reorg is not a simple matter
> of moving a file from here to there.  It will require a lot
> moving about of sections and a lot of word-smithing to glue
> them back together again in a coherent way.

Concerning this particular issue, not everyone would
agree that the doc sections in question are misplaced.

In Python the distinction between builtin and library
types is fairly blurry. There are advantages to having
them all documented in one place -- when looking for
info about a type, you don't have to try to guess
whether it's considered built-in or not to know which
manual to look in.

-- 
Greg



More information about the Python-list mailing list