Improve docs for update_with_password

Closes #2942