Use NumPy documentation standard to document functions

[stefanv]

Take a look at any function in numpy, scipy, or scikit-image for an example, or refer to

https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt