better docs

@charlierudolph this is inspired by one of your comments. Please take a look!  :)
Okay. Personally "updates the current branch" is still to generic. "update" could mean anything. What about bring "updates the current branch with all relevant changes"? That implies we are adding things to the branch and relevant changes is the generic part since we have different behavior for different types of branches.