improve jsdoc annotations