Change from markdown to rst for README

This gets included in the docs site as well!
Update docstrings a bit
Add an ignore for gh-pages subdir

This is where I have a worktree for gh-pages in gh-pages/html/ so that I
can easily publish html stuff from sphinx and push it out.