added api docs and updated rando