doc clarification for 2.x