[docs] [issue12874] Rearrange descriptions of builtin types

Nick Coghlan report at bugs.python.org
Thu Sep 1 00:42:41 CEST 2011


New submission from Nick Coghlan <ncoghlan at 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 at python
components: Documentation
messages: 143284
nosy: docs at python, ncoghlan
priority: normal
severity: normal
status: open
title: Rearrange descriptions of builtin types
versions: Python 3.3

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


More information about the docs mailing list