Issue 30466: Tutorial doesn't explain the use of classes (original) (raw)

Issue30466

Created on 2017-05-24 22:58 by trey, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Messages (5)
msg294409 - (view)	Author: Trey Hunner (trey) *	Date: 2017-05-24 22:58
The tutorial page for classes starts with "Compared with other programming languages". While object-oriented programming and classes are popular in many programming languages, not everyone learning about Python's classes is familiar with the concept. I teach both new programmers and programmers who have heard of object-oriented programming but never created a class before. I think the first paragraph on this page should be a brief explanation of the use of classes. It may also be a good idea to have a "Why classes?" section explaining the uses of classes in more detail.
msg294418 - (view)	Author: Raymond Hettinger (rhettinger) *	Date: 2017-05-25 00:34
This particular PR seems fine. I'll review it in more detail later. In general, the tutorial is intended to be a structured overview of the language rather than a how-to-program lesson. Concepts are usually linked to the glossary or external sources and some information is communicated indirectly by the examples.
msg298255 - (view)	Author: Mariatta (Mariatta) *	Date: 2017-07-13 02:30
New changeset 3fbd70018f835edd33250de2f79b7a7ef45f8359 by Mariatta (Trey Hunner) in branch 'master': bpo-30466: Add brief explanation of classes to tutorial (GH-1804) https://github.com/python/cpython/commit/3fbd70018f835edd33250de2f79b7a7ef45f8359
msg298422 - (view)	Author: Raymond Hettinger (rhettinger) *	Date: 2017-07-16 07:15
Apparently this was committed without my review.
msg298764 - (view)	Author: Mariatta (Mariatta) *	Date: 2017-07-21 03:10
New changeset ef4231adb7aa6b323c94e854ac3dc3bebc841115 by Mariatta (Trey Hunner) in branch '3.6': bpo-30466: Add brief explanation of classes to tutorial (GH-1804) (GH-2700) https://github.com/python/cpython/commit/ef4231adb7aa6b323c94e854ac3dc3bebc841115