Usually, the numpydoc format is the easiest to use and read for docstrings.
In order to make things Just Work, use the following in conf.py
:
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.autosummary',
'sphinx.ext.doctest',
'sphinx.ext.intersphinx',
'sphinx.ext.todo',
'sphinx.ext.coverage',
'sphinx.ext.mathjax',
'sphinx.ext.viewcode',
'numpydoc'
]
numpydoc_show_class_members = False
autosummary_generate = False