To build locally

Install Sphinx
Run the command sphinx-build -n . _build in this directory.
Open the file _build/index.html in your browser to view.

To deploy

build the docs: sphinx-build -n . _build
check the build
remove the cached build files rm -fr .doctrees
move the build out of the repo dir: rm -r /tmp/_build; mv _build /tmp
check out the gh-pages branch: git checkout gh-pages && git pull
remove previous files: rm -r *
move new files in: mv /tmp/_build/* .
commit and push: git add . && git commit -m 'Updated docs' && git push