Some clarifications in docs