docs: suggest refined github

[jacopoabramo]

References and relevant issues

Description

Since I discovered refined github, might as well mention this in the documentation as it changed my life and now I don't even know how I could have lived without it.

It just adds a small tip referencing the github project. I might provide a link directly to their installation process though.

[brisvag]

How about using a side margin note? I feel like we could use these more, for stuff that's really just a "btw..." kinda message.

[jacopoabramo]

Hmmm how would that look like?

[TimMonko]

TIL! https://pydata-sphinx-theme.readthedocs.io/en/stable/user_guide/theme-elements.html#admonition-sidebars

I might start making good use of this if it looks good in our styling / docs / scrolling. I find admonitions/extra info so helpful but I HATE how it interrupts vertical flow. This might be neat to reapproach our docs with

[jacopoabramo]

This is how it looks like with a sidebar (haven't tried admonition but can render it if you're interested).

I must admit I'm not a fan of this. Maybe the text needs to be shorter but I would still prefer the tip approach.

[jacopoabramo]

With the admonition the text is too close to the edge of the box. Uh.

[TimMonko]

Approving in its current stage. I also agree that the margin version is a bit 😵‍💫