I'd be keen to use numpydoc form here (https://github.com/matplotlib/matplotlib/wiki/Mep10)