'Unexpected Section Title' with Sphinx — is numpy the issue?

Question

When running

sphinx-build . html/

in my doc/ directory, I get the following output:

$ sphinx-build . html/
Run         


        

Answer 1

The subject is discussed in this thread: https://groups.google.com/d/msg/sphinx-users/MAFTlX8pAvk/B9hx7MuBVbIJ

Pierre GM says: "fredrik, Looks like you're using thw numpy standard for your documentation. Consider then using the numpydoc extensions that Pauli Virtanen implemented: it's available here: http://sphinx.googlecode.com/svn/contrib/trunk/ "

Current information abut numpydoc: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt

Moved information about NumpyDoc: https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard