readthedocs / sphinx-autoapi

A new approach to API documentation in Sphinx.
https://sphinx-autoapi.readthedocs.io/
MIT License
432 stars 128 forks source link

Files without docstring at the top are not listed #361

Closed bwulff closed 1 year ago

bwulff commented 1 year ago

When there is no docstring at the top of a .py file that file is never listed in the documentation. Although there is corresponding html output in the build directory.

Is this an intended behavior?

Is there a workaround? Because that is the awesomeness I choose autoapi for: just point at the source folder and everything is documented automatically...

bwulff commented 1 year ago

I unset the undoc-members option