Update documentation on how :func:`pytest.warns` affects :class:`DeprecationWarning`.