Add lots of docs

First step towards #114
Strictly speaking, it could be 1D as well as 3D