mikal dropped the 'random' part of the docblock. Do we need it again or is it safe to assume everything is random.