Improve documentation

[aph42]

Two other ideas for the docs that I'd like to see:

1. Use of real data in the gallery. We have now a repository of sample data; can we use it in the gallery examples?
2. Clean up the later bits of the tutorial to rely more on the binder notebooks