As much as possible, try using the new MEP10 conventions for the documentation. It corresponds to numpydoc's formatting.

More detail can be found here: https://github.com/matplotlib/matplotlib/wiki/Mep10