add test for example.ipynb and automate documentation

[chrisjsewell]

See:
http://nbsphinx.readthedocs.io

and
http://blog.thedataincubator.com/2016/06/testing-jupyter-notebooks/
https://gist.github.com/minrk/2620735