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

[R. David Murray]

R. David Murray added the comment:

I think Ezio's idea is great.  I would not want to see the notices at the top, but a label would make things clear (and the label could be hyperlinked to the note, since sometimes they are a bit of a distance away).

Someone has to figure out the Sphinx programming, though.

Note that the 'new' label should only appear for stuff that is new in that release.  It's not clear to me if it should appear at all in the docs for maintenance releases...that should be discussed.

----------
nosy: +r.david.murray

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