[docs] [issue33252] Clarify ResourceWarning documentation

[Nick Coghlan]

Nick Coghlan <ncoghlan at gmail.com> added the comment:

+1 from me for further ResourceWarning docs improvements - my focus when working on PEP 565 was the actual change in how DeprecationWarning was being handled, and the other warnings doc improvements were just a necessary prerequisite for being able to convey that clearly.

The backport to 3.6 may or may not be worthwhile, depending on how much work it proves to be in practice (while those will still be the default online docs for the next couple of months, the 3.7 branch will take their place once 3.7.0 is officially released).

We wouldn't backport docs changes to 3.4 or 3.5, as both of those branches are already in security-fix-only mode.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33252>
_______________________________________