[issue30466] Tutorial doesn't explain the use of classes

[Mariatta Wijaya]

Changes by Mariatta Wijaya :


--
resolution:  -> fixed
stage: backport needed -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Mariatta Wijaya]

Mariatta Wijaya added the comment:


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


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Raymond Hettinger]

Raymond Hettinger added the comment:

Apparently this was committed without my review.

--
assignee: rhettinger -> 

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Trey Hunner]

Changes by Trey Hunner :


--
pull_requests: +2766

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Mariatta Wijaya]

Changes by Mariatta Wijaya :


--
stage: patch review -> backport needed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Mariatta Wijaya]

Mariatta Wijaya added the comment:


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


--
nosy: +Mariatta

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Raymond Hettinger]

Raymond Hettinger added the comment:

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.

--
assignee: docs@python -> rhettinger
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Mariatta Wijaya]

Changes by Mariatta Wijaya :


--
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Trey Hunner]

Changes by Trey Hunner :


--
pull_requests: +1887

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue30466] Tutorial doesn't explain the use of classes

[Trey Hunner]

New submission from Trey Hunner:

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.

--
assignee: docs@python
components: Documentation
messages: 294409
nosy: docs@python, trey
priority: normal
severity: normal
status: open
title: Tutorial doesn't explain the use of classes
type: enhancement
versions: Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com