[Python-Dev] Python Library Reference top page too long

Georg Brandl g.brandl at gmx.net
Fri Mar 17 07:32:43 CET 2006


Greg Ewing wrote:
> Russell E. Owen wrote:
> 
>> Fundamentally I think what's wanted is:
>> - Another level of sub-TOCs, e.g. one for "Sequence Types", "Mapping 
>> Types", etc. Every page that has sub-topics or intimately related should 
>> have a list of them at the beginning.
>> - The special methods for a given type of class would make a really good 
>> "intimately related" topic for "Sequence Types" and "Mapping Types".
> 
> +1 to all that.

I agree that the docs on __special__ methods really are hard to find if
you don't know where to look.

>> Another thing that would be *really* useful is to list the actual 
>> built-in types with the category. For example:
>> Sequence Types (str, unicode, list, tuple, buffer, xrange)
>> Mapping Types (dict)
> 
> +1

If I understand correctly what you mean, that's already done.

Georg



More information about the Python-Dev mailing list