These docstrings do not conform to numpy/scipy standards, which was discussed at one point as being the guide to follow. This is also a point where it could be done differently across different parts of the package if style is not meant to be followed strictly.