DOC: make some of the docstrings conform with NumPy style
Created by: magnunor
I went through the doc-strings and changed them so they follow the NumPy style, which is also the same style which is used in SciPy, matplotlib and HyperSpy.
https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_numpy.html