#1: add script to update gh-pages

doc/.gitignore

@@ -1 +1,2 @@
 doctrees
+gh-pages

doc/Makefile

@@ -18,3 +18,7 @@ help:
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+
+gh-pages:
+	@./update-gh-pages.sh

doc/update-gh-pages.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -ex
+CLONE_URL=$(git remote -v | grep origin | head -n1 | awk '{print $2}')
+if [ ! -d gh-pages ]; then
+    git clone -b gh-pages ${CLONE_URL} gh-pages
+else
+    (cd gh-pages && git pull origin gh-pages)
+fi
+
+cd gh-pages
+rm -rf *
+cp -r ../html/* .
+git add -A
+git commit -m 'Update docs'
+git push origin gh-pages