clarifying iterator trait documentation