It would be an improvement to conform to the [numpydoc standard](https://numpydoc.readthedocs.io/en/latest/format.html) to improve readability both in the terminal and in the rendered html.