Write good and formated docstrings

[guilgautier]

It is important to write more explicit docstrings, and decide which docstring format to use and stick to it.
you can have a look at this compact post https://stackoverflow.com/a/24385103

Note: you can partially automate docstring generation in your text editor, in VS-Code for example there's https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring

[guilgautier]

Everything seems pretty much ok now!