Adding docstring to interactive

[hoxbro]

An attempt at adding the docstring for interactive. I have kept the class docstring in the code, but because it is heavily developer-focused, I have removed it when using ? in a notebook.

[MarcSkovMadsen]

When I have been making these changes I've normally been doing them on the Class because VS Code tooltips use this instead of the __init__ docstring. If I am actively typing the parameters MyClass(name=...) then it uses the __init__ docstring if it exists and falls back to the Class docstring otherwise.

How does your approach work in VS Code @hoxbro ? My guess is that the Class docstring needs to be for users too. And then you can optionally add the __init__ or __call__. But all of them should be targetted users as they will see and need them at different times.

[MarcSkovMadsen]

See comment in post about whether the docstring should be on the Class, __init__ or __call__ level.

[maximlt]

Thanks a lot @hoxbro , I've just re-arranged the docstrings, which mostly consisted in moving the How it works section out of the Interactive docstrings. Both the Interactive class and its __call__ method have a docstring, so that it will appear in an IDE like VSCode in both situations.