make html
comments in Python source code
Python docstrings
setuptools
recommonmark
docs directory
the docs directory
tox
After enabling markdown extension in Sphinx configuration, there's a warning about docs/README.md not being included in the toc tree. Since docs/README.md is not to be included in the final rendered document, we'll keep it as a .txt document.