added userguide

and changed docblocks