OK ... I'll go further through the docs tomorrow and I also have a student that can help with docs testing.

I think this is really needed before the 0.3 branch is created ... see e.g. #1570 for convolution.