documented roles, other minor wording fixes