Add more examples in the `warnings` docs

[ezio-melotti]

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

[Jamesgo1]

Hi there, first time contributor here. I'd be happy to attempt this if that would be OK?

[hugovk]

@Jamesgo1 Hi, that would be great, thanks!

See https://devguide.python.org for info about building docs and contributing PRs, and also feel free to ask here too.

[liam-gersten]

Hello, my name is Liam, and I’m part of a student software engineer group of 4 at Carnegie Mellon. We’ve been tasked with contributing to an open source project, and this issue seems like a great first start. Would you mind assigning this to me (my group)? Also, you might see the same comment on 1-2 other issues, since we’ll likely be working on more than just one for our assignment.

[hugovk]

Hi Liam and your group! Sounds great!

We don't usually assign issues, because sometimes people don't get around to making PRs for a wide variety of reasons, and we don't want others to think they've been pre-booked.

Instead, please go ahead with it, and don't hesitate to ask questions :)