STINNER Victor <vstin...@python.org> added the comment:
> 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. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <https://bugs.python.org/issue28533> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com