Nick Coghlan <ncoghlan(a)gmail.com> added the comment:
Bringing a suggestion over from #12874, I think it may be worth splitting the current "Sequence Types" section into 3 pieces that all appear in the top level table of contents for the library reference:
4.6 Sequence Types - list, tuple, range
4.7 Text Sequence Type - str
4.8 Binary Data Sequence Types - bytes, bytearray, memoryview
----------
nosy: +ncoghlan
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue4966>
_______________________________________
New submission from Nick Coghlan <ncoghlan(a)gmail.com>:
Section 4 of the Standard Library reference currently includes the two following sections (amongst others):
4.6. Sequence Types — str, bytes, bytearray, list, tuple, range
4.9. memoryview type
This is crazy - memoryview, a fairly niche type, gets its own second tier section on the main table of contents, while str, one of the most important types in Python, is tucked away under the generic "Sequence Type" heading?
I propose that these sections be rearranged as:
4.6 Sequence Types - list, tuple, range
4.7 Text Types - str
4.8 Binary Data Types - bytes, bytearray, memoryview
The Set Types and Mapping Types sections would slide down to sections 4.9 and 4.10 to make room for the two new sections.
----------
assignee: docs@python
components: Documentation
messages: 143284
nosy: docs@python, ncoghlan
priority: normal
severity: normal
status: open
title: Rearrange descriptions of builtin types
versions: Python 3.3
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue12874>
_______________________________________
