docs: upgrade: make upgrade instructions from version control more explicit

Instruct users to make a note of the orginal and new revision, both to help
in any failure analysis, and also to let them realize when the 'hg update'
command failed.