This is a follow-up of GH-86438 and GH-23172. The warnings docs should include more examples to show how to match different types of warnings using both the provided functions and -W/PYTHONWARNINGS, especially since they behave differently.

At the bottom of pytest-dev/pytest#8759 (comment) there are already some examples to illustrate some of the differences, even though some are specific to pytest.

Linked PRs

• gh-93343: Expand warning filter examples #106618