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

Raymond Hettinger report at bugs.python.org
Thu Dec 16 10:09:02 CET 2010


Raymond Hettinger <rhettinger at users.sourceforge.net> added the comment:

FWIW, whatsnew is not primary documentation -- it should not be the sole or central source of anything except a highlevel overview and examples for the author's choice of selected version differences to highlight. 

A howto document would work best as a central place to list all deprecations and advice on what to do about them.

----------

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


More information about the docs mailing list