Various clarifications in docs