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