For someone new to sphinx going through the simple setup is quite difficult and confusing to figure out how to use autodoc:
- what is autodoc? an extension? a module? a command?
- how to install the autodoc?
- how to set the source code path with sys.path.insert(0, os.path.abspath('.')) ?
- a working example of setting up autodoc complete with everything, not just incomplete bits and pieces