make minor clarifications in docs