[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