improve jsdoc, remove api from readme