small fixes to upgrade doc