Userguide

Fixes #121 #118 and #128 
Please review