changed header for new get_random def
documentation changes