Sphinx Autodoc and NumpyDoc

despite reading this tutorial, this question and the numpy docstring standard, I'm unable to get sphinx autodoc to play nicely with numpy docstrings. In my `conf.py` I have: ``` extensions = ['sphinx.ext.autodoc', 'numpydoc'] ``` and in my doc file I have: ``` .. automodule:: python_file .. autoclass:: PythonClass :members: ``` where `python_file.py` has: ``` class PythonClass(object): def do_stuff(x): """ This does good stuff. Here are the details about the good stuff it does. Parameters ---------- x : int An integer which has amazing things done to it Returns ------- y : int Some other thing """ return x + 1 ``` When I run `make html` I get `ERROR: Unknown directive type "autosummary"`. When I add `autosummary` to my `extensions` thus: ``` extensions = ['sphinx.ext.autodoc', 'numpydoc', 'sphinx.ext.autosummary'] ``` I get: ``` WARNING: toctree references unknown document u'docs/python_file.PythonClass.do_stuff' ``` As recommended by this question, I add `numpydoc_show_class_members = False` to my `conf.py`. Now I can run `make html` without errors, but the `Parameters` and `Returns` sections are not interpreted as being numpydoc sections. Is there a way out of this mess?