doc for try_upgrade, try make it more readable