Create gallery of realistic examples

[Borda]

🚀 Feature

Motivation

We have some doctests to demonstrate immediate use, which is great but having demos with real-work examples would also be great for new users...

Pitch

have visual

Alternatives

We may not use our tutorials as they are optimized for long-running code, so we can try a simpler tool: https://sphinx-gallery.github.io/stable/index.html

Additional context

having these examples in Python script instead of notebooks directly...

so 🟢 advantages:

• regularly verified reproducibility
• smaller footprint for the git versioning

and 🟥 disadvantages:

• not so cute view directly in GH