docstrings, update random numbers example based on review