As I remember the webmaster@ discussions, Mats did go so far as to start a re-write of the classes section, but it never got as far as a PR.

Kind regards,
Steve


On Fri, Nov 6, 2020 at 5:51 PM Guido van Rossum <guido@python.org> wrote:
Ouch, that's bad. It seems the class tutorial could use an overhaul.

We might also cut a few areas where we go unnecessarily deep (e.g. position-only parameters).

On Fri, Nov 6, 2020 at 9:31 AM Mats Wichmann <mats@wichmann.us> wrote:
On 11/6/20 9:07 AM, Marco Sulla wrote:
> I started to learn Python with the tutorial, and two things come into my
> mind:
> 1. The class section seems quite difficult and intimidating for a novel,
> while classes in Python are really more simple than in other OO languages

Indeed - we got some complaints about the class chapter at the
webmaster@python.org alias a while back. The introductory section
repeatedly mentions Modula-3 and Smalltalk, languages which more
recently minted programmers aren't very likely to be familiar with,
which makes it a bit of a daunting beginning - this is the one chapter
that could really use a bit of rework, IMO.

_______________________________________________
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-leave@python.org
https://mail.python.org/mailman3/lists/python-dev.python.org/
Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/B54VI2DN2AYUXJG4SWSW2BMU5OOCIGSX/
Code of Conduct: http://python.org/psf/codeofconduct/


--
--Guido van Rossum (python.org/~guido)
_______________________________________________
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-leave@python.org
https://mail.python.org/mailman3/lists/python-dev.python.org/
Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/QRWFPASA6TKQCDSIOUBYU5OGHPFAUXW3/
Code of Conduct: http://python.org/psf/codeofconduct/