First pass of doc about randomness.  This won't be that practically
useful until we have more client implementations.