Minor fixes 

Hi,

these are a few minor improvements over documentation and tests, I hope I have ironed out all the rough edges.


Regards,
Matteo