documentation

clarifying randomization