improved inline documentation for jsdoc