- `make ghpages` will build the docs in docs/build/html and push it to an
existing gh-pages branch; especially useful when building on a fork;
you will have to initialize your gh-pages branch manually and enable
docs on the gh-pages branch in the repo settings
- ignore build directories (top level build and docs/build)
- custom _template/autosummary/module.rst to include docs
for all module :members" (shows up directly after the summary
tables)
- module docs should *not* contain autodocs for members, only general
descriptions and examples
- all files inside api/ are autogenerated whenever sphinx is run
(no need to add to the repository, hence excluded in .gitignore)
