Not Very Humerus
Open-source bioinformatics blog
Hi everyone, have you ever wondered what would be a good idea for an app? Since I became a developer, now I have *some* of the tools to potentially create some basic web applications, command line tools, etc. For some developers who aren't creating regularly, it may seem like your work actually gets in the way of the creative process, and you might not get the time to make that killer app you really wanted to build.
I’ve been exploring the Python documentation system for ReadTheDocs with Sphinx. It could be that I’m dense, but the
sphinx-quickstart command seems horribly divorced from most of the automagic documentation goals of the Sphinx project. After following several guides1, 2 I noticed that only an index.rst had been created in the
_sources directory. Brandon’s guide suggests that adding your module to either your PYTHONPATH or to your conf.py before
make html would lead to autodoc recognizing your package. I wasn’t able to get this to work on OSX Sierra using a virtualenv. After looking through more tutorials, I encountered some suggestions for the
sphinx-apidoc command, without actual invocation details.