used sphinx-apidoc to automatically document _all_ modules/submodules
~/repos/discoursegraphs $ sphinx-apidoc src/discoursegraphs -o docs
fixed lots sphinx documentation warnings (i.e. all warnings that I'm resposible for)