updates and clarifications to upgrade process