[docs] [issue28362] Deprecation warning doesn't stand out enough

[Berker Peksag]

Berker Peksag added the comment:

It was rendered in a red box, because we were using an old Sphinx CSS file (Doc/tools/static/basic.css) [1] We are using Sphinx defaults now and Python specific tweaks are located at Doc/tools/pydoctheme/static/pydoctheme.css.

We usually prefer to use less disruptive visual elements (including using less gray note directives) in Python documentation. The exception to this is security warnings. See https://docs.python.org/3.5/library/xml.html and https://docs.python.org/3.5/library/ssl.html for example.

I recommend to close this as "wont fix".

[1] Removed in https://github.com/python/cpython/commit/7c366a72ac56814edaf3fb2718b08441aff31d3a

----------
nosy: +berker.peksag

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