changes to README, jsdoc and tests