Common style for doc strings

currently there are several different formats used for doc string in functions and classes

I would suggest to use the numpy style doc strings, an example can be found here

we could also add a CI test which checks for the doc strings