Could of clarifications to docs