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