[docs] [issue34839] doctest: Change example under warnings section
Stéphane Wirtel
report at bugs.python.org
Sat Oct 6 01:12:25 EDT 2018
Stéphane Wirtel <stephane at wirtel.be> added the comment:
Hi Terry,
You say we need to keep this illustration with a section 'before 3.6' but in think it's a bad thing.
1. when you read a documentation, you just copy the example, and sometimes you don't read the requirements.
2. why do we need to keep an illustration for a previous version of Python? since >= 3.6 we keep the order (officially in 3.7), in this case, the example is useless, because you read the documentation of >= 3.7.
I would prefer to remove this example for >= 3.6 and keep the illustration for the previous version.
I am really interested by the feedback of Tim, Cheryl and Raymond.
----------
nosy: +matrixise
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue34839>
_______________________________________
More information about the docs
mailing list