[2.7] bpo-33600: document that platform.linux_distribution() has been removed by timofurrer · Pull Request #7281 · python/cpython
Perhaps use a Note like in urllib?
I looked at the HTML output. Honestly, if you don't read carefully the whole documentation, you can easily miss the new note.
I modified the doc to use a ".. note::" and I agree that it's much easier to catch this note. So yes, please, @timofurrer: modify your PR to write the new paragraph as a note.
Returns a tuple ``(distname,version,id)`` which defaults to the args given as
parameters. ``id`` is the item in parentheses after the version number. It
is usually the version codename.
.. note::
This function is deprecated since Python 3.5 and removed in Python 3.8.
See alternative like the `distro <https://pypi.org/project/distro>`_
package.
.. versionadded:: 2.6