More docs' cleanup and clarification