added random function

don't include an example if it's dotted out