python / cpython

The Python programming language
https://www.python.org
Other
62.31k stars 29.93k forks source link

make the Classes tutorial more gentle #58427

Open ccda776a-4736-4dbd-bf35-88e58f6952ba opened 12 years ago

ccda776a-4736-4dbd-bf35-88e58f6952ba commented 12 years ago
BPO 14219
Nosy @merwok, @sandrotosi

Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.

Show more details

GitHub fields: ```python assignee = None closed_at = None created_at = labels = ['type-feature', '3.9', '3.10', 'docs'] title = 'make the Classes tutorial more gentle' updated_at = user = 'https://bugs.python.org/tshepang' ``` bugs.python.org fields: ```python activity = actor = 'iritkatriel' assignee = 'docs@python' closed = False closed_date = None closer = None components = ['Documentation'] creation = creator = 'tshepang' dependencies = [] files = [] hgrepos = [] issue_num = 14219 keywords = [] message_count = 2.0 messages = ['155065', '155069'] nosy_count = 4.0 nosy_names = ['eric.araujo', 'sandro.tosi', 'docs@python', 'tshepang'] pr_nums = [] priority = 'normal' resolution = None stage = None status = 'open' superseder = None type = 'enhancement' url = 'https://bugs.python.org/issue14219' versions = ['Python 3.9', 'Python 3.10'] ```

ccda776a-4736-4dbd-bf35-88e58f6952ba commented 12 years ago

Looking at Doc/tutorial/classes, the section "Python Scopes and Namespaces" is full of heavy/deep information. I expect that people who would be able to properly digest that info are people who are already advanced at Python, and therefore maybe it should be moved to some cookbook (or language reference). I would prefer something gentler, since the tutorial is for Python newbies who aren't necessarily conversant with OO concepts.

There can of course be links to heavier material for deeper understanding.

sandrotosi commented 12 years ago

see msg155067