write some proper docs and move the tutorial there

[grahamgower]

Right now it's a bit silly, because every other commit probably needs to have a corresponding update to tutorial.ipynb.

[grahamgower]

Docs are up!