rename function and clarify docs