more doc clarification