updated readme and jsdocs - #30