added jsdoc blocks to modal