Raymond Hettinger <rhettinger@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@bugs.python.org> <http://bugs.python.org/issue10669> _______________________________________