[New-bugs-announce] [issue38539] Update demo files

Julin report at bugs.python.org
Sun Oct 20 15:17:35 EDT 2019


New submission from Julin <julinshaji02 at gmail.com>:

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?

----------
components: Demos and Tools
messages: 355013
nosy: ju-sh
priority: normal
severity: normal
status: open
title: Update demo files
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8, Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue38539>
_______________________________________


More information about the New-bugs-announce mailing list