JT: the sphinx tutorial looks very good, but you might add this the the quickstart
```
> githubpages: create .nojekyll file to publish the document on GitHub pages (y/n) [n]: y
```