update internal documentation to jsdoc style