add jsdoc
add docs des for randoms.js