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 vstinner
Recipients Mariatta, aeros, asvetlov, barry, dankreso, grzgrzgrz3, iritkatriel, jacksonriley, nanjekyejoannah, orsenthil, vstinner, yselivanov
Date 2021-11-12.13:29:23
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
> One concern I have is when users follow internet examples and look out for these modules or examples.

Well, we cannot modify printed books :-)

> What is the best way to show them the modern usage?

Buy new books? :-)

> Should Python docs show some example snippet of the most common usage of aiosmtpd ?

I don't think that we should start providing tutorial for 3rd party modules. There are enough places on the Internet for that.

For example, what is aiosmtpd deprecated a function and our doc uses it? Once a Python version reaches its "security-only" fixes, we cannot modify the doc anymore, and you fall into the same problem again.

> A stdlib page dedicated to removal, and showing examples using these modules, especially aiostmpd as it is not a part of stdlib, might be a good idea.

IMO it's way better to maintain such documentation outside Python itself. It's simpler to keep it up to date.
Date User Action Args
2021-11-12 13:29:23vstinnersetrecipients: + vstinner, barry, orsenthil, asvetlov, yselivanov, grzgrzgrz3, Mariatta, nanjekyejoannah, aeros, jacksonriley, dankreso, iritkatriel
2021-11-12 13:29:23vstinnersetmessageid: <>
2021-11-12 13:29:23vstinnerlinkissue28533 messages
2021-11-12 13:29:23vstinnercreate