JamesALeedham

sphinx.ext.autosummary with automatic recursion doesn't follow legitimate import statement in __init__.py file

7

**Describe the bug** Sphinx fails to import & document a module that is itself imported in an `__init__.py` file. I'm at a loss as to understand why; on the face...

By default, make Autosummary templates generate documentation pages for classes, functions, exceptions etc

19

**Is your feature request related to a problem? Please describe.** The new `:recursive:` option for `sphinx.ext.autosummary` is great. I can point Sphinx at the top of my package and have...

Alternative automatic API ref doc generation

2

## Automatically generating API reference doc rather than using `generate_module_rst.py` file ### Description Enhancement. There are pros and cos to this new method. See https://docs.google.com/document/d/1AIV8-nGOAzqzrzcA8mxpcgdGKDKyQ9wpjVweCyFbl1g/edit for a comparison with the...

Check out [this page containing API doc](https://gpflow.readthedocs.io/en/master/gpflow/conditionals/index.html#gpflow-conditionals-conditional) for the `gpflow.conditionals.conditionals._conditional` function (screenshot of key section below). As I understand it, this doc is supposed to say (something like): - "If...