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 :green_circle: advantages:

• regularly verified reproducibility
• smaller footprint for the git versioning

and :red_square: disadvantages:

• not so cute view directly in GH