For the sake of consistency, we should probably keep the part before "Parameters" to one line as described [here](https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#sections), and move the rest to a Notes section below.