doc clarification