New submission from Nick Coghlan <ncogh...@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 <rep...@bugs.python.org>
<http://bugs.python.org/issue12874>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to