Author tim.peters
Recipients cheryl.sabella, docs@python, lys.nikolaou, matrixise, rhettinger, terry.reedy, tim.peters
Date 2018-10-06.05:27:27
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1538803648.03.0.545547206417.issue34839@psf.upfronthosting.co.za>
In-reply-to
Content
Stephane, it's not deep.  People who need to write doctests that work across N versions of Python shouldn't need to read N versions of the documentation.  This is hardly unique to doctest.  We routinely add "Changed in version m.n" blurbs all over the place.

Ways that were _necessary_ for robust dict testing continue to work fine in 3.6 and 3.7, so it doesn't harm anything if people mindlessly copy an example that _could_ be spelled some other way under 3.6+.  It's not like there's even anything slightly obscure about, e.g.,

>>> foo() == {"Hermione": "hippogryph", "Harry": "broomstick"}
True
History
Date User Action Args
2018-10-06 05:27:28tim.peterssetrecipients: + tim.peters, rhettinger, terry.reedy, docs@python, matrixise, cheryl.sabella, lys.nikolaou
2018-10-06 05:27:28tim.peterssetmessageid: <1538803648.03.0.545547206417.issue34839@psf.upfronthosting.co.za>
2018-10-06 05:27:28tim.peterslinkissue34839 messages
2018-10-06 05:27:27tim.peterscreate