random doc improvements

Change-Id: I5dca4ca660ee6423c26e33e3b4643a67d99f1ad2
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>