(Moved from trello) Regarding the docstring: Should we try to adhere to: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#docstring-standard