Add lots of docs

First step towards #114
What does the `+` mean here? Could you make this clearer?