New submission from Anthony Bartoli:
From the library's introduction page:
This manual is organized “from the inside out:” it first describes the
built-in data types...
The library manual first describes built-in functions, not data types.
After built-in functions, it describes built-in constants, built-in types, and
built-in exceptions. Lastly, it describes modules grouped by related
functionality.
A suggested re-write *for the entire paragraph*:
The library manual first documents built-in functions, built-in constants,
built-in types, and built-in exceptions. Then it documents modules grouped by
related functionality.
I suggest eliminating the last sentence:
The ordering of the chapters as well as the ordering of the modules within
each chapter is roughly from most relevant to least important.
Importance is subjective and parts of the manual are organized alphabetically,
not by relevance / importance.
--
assignee: docs@python
components: Documentation
messages: 219860
nosy: AnthonyBartoli, docs@python
priority: normal
severity: normal
status: open
title: Library - Introduction - paragraph 5 - wrong ordering
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21675
___
___
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
