add documentation to methods.

[alexserver]

@mkrn I remember we were talking about this in our last call. Shall we use markdown or regular javascript documentation spec ? like http://usejsdoc.org/