More doc clarifications