clarify upgrading docs