refs #552, #547 - updated upgrading documentation