See https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt
just before item 5