[docs] [issue10669] Document Deprecation Warnings and how to fix

[Éric Araujo]

Éric Araujo <merwok at netwok.org> added the comment:

PEP 4 and PEP 290 are related to this subject, but not comprehensive, not on docs.python.org, and not tutorial-like.

I think we could try Ezio’s idea.  Sphinx can produce a document containing only version* directives (“make changes”).  If such a document is clear enough and has links to the longer docs, there would be no need to write separate howtos.

----------
nosy: +eric.araujo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10669>
_______________________________________