[docs] [issue25467] Put “deprecated” warnings first

Changes by Brett Cannon <brett@python.org>: ---------- nosy: +brett.cannon _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue25467> _______________________________________