Document Random class

New: add documentation for all methods.

Change: class description.