adding jsdoc comments to random()