A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

And if you don't make the requested changes, you will be poked with soft cushions!

I have made the requested changes; please review again

Thanks for making the requested changes!

@vstinner: please review the changes made to this pull request.

This has some precedent in e.g. urllib docs.
Perhaps use a Note like in urllib? But this way it looks fine too, to me at least.

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

@vstinner done!

@timofurrer: Thank you Timo Furrer for your contribution! It's better as the note ;-)

Thanks @encukou for the review as well.