This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ju-sh
Recipients ju-sh
Date 2019-10-20.19:17:34
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1571599055.13.0.42950539659.issue38539@roundup.psfhosted.org>
In-reply-to
Content
The demo programs inside Tools/demo, which is to guide people new to the language (that's the purpose, right?), makes use of several bad coding practices.

Like
 - `while 1:` being used instead of `while True:`
 - star import
 - function call and an `if` statement being on the same line, etc.

It can easily mislead someone new to the language especially since it is part of the codebase and part of distribution as well.

Can we update these files? Most of these seem have not been updated in some time.

A discussion touching this problem on #python-dev suggested that the demos were written when the docs were yet to be polished and now that we have a fully fledged documentation, maybe the demo files can be dropped.

But since the bpo has an option 'Demos and tools' under 'components', I guess maybe the demos are still considered essential.

What do you all think?
History
Date User Action Args
2019-10-20 19:17:35ju-shsetrecipients: + ju-sh
2019-10-20 19:17:35ju-shsetmessageid: <1571599055.13.0.42950539659.issue38539@roundup.psfhosted.org>
2019-10-20 19:17:35ju-shlinkissue38539 messages
2019-10-20 19:17:34ju-shcreate