[New-bugs-announce] [issue6486] Library doc introduction strangely points to "Built-in Objects" as a starting point

[Mitchell Model]

New submission from Mitchell Model <mlm at acm.org>:

At the end of the introduction page of the library documentation  there
is a strange suggestion to begin with "Built-in Objects" as a starting
point. The "Built-in Objects" page consists of two paragraphs that will
surely mystify people new to Python. I'm not sure where it was supposed
to point -- built-in functions? built-in types? But surely not "Built-in
Objects"?

Or another interpretation, which on deeper investigation, strikes me as
the correct one: "Built-in Objects", which references tables, operators,
etc. that don't appear on that page, is simply an introduction to
"Built-in Types", or an introduction to all the subsequent chapters. In
that case, I see the challenge for structuring the top-level chapters of
the library documentation, but perhaps these two paragraphs could simply
be moved to the introduction and the "Built-in Objects" eliminated.
Besides, aren't built-in functions and constants, which come before this
page, built-in objects too?

----------
assignee: georg.brandl
components: Documentation
messages: 90524
nosy: MLModel, georg.brandl
severity: normal
status: open
title: Library doc introduction strangely points to "Built-in Objects" as a starting point
versions: Python 2.7, Python 3.0, Python 3.1, Python 3.2

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