[docs] [issue4966] Improving Lib Doc Sequence Types Section

Ezio Melotti report at bugs.python.org
Fri Mar 11 00:19:50 CET 2011


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

This is maybe out of the scope of this issue, but I would like to see all the basic data types on single page on their own.  The current page[0] has some section about data types mixed with sections about operations, comparisons, and other things, followed by less-"used" types.  The page also contains lot of informations and it's not easy to browse (42 screens on a 24" monitor).

Ideally the structure should be something like:

1. True, False, None
2. int, float(, long, complex)
3. str, unicode, list, tuple(, bytearray, buffer, xrange)
4. dict
5. set(, frozenset)

(where the types in () are considered less important -- so maybe described in detail later or in another page).  The page can list common operations for each group and their methods, but leaving things like the string formatting operations to another page/section.


[0]: http://docs.python.org/library/stdtypes.html

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue4966>
_______________________________________


More information about the docs mailing list