Integrate UPGRADING from the main repo #721
Description
The main repo has UPGRADING.md, which should be on the Web site as well.
TODO
- Explain cancelled CLI deprecations clearly ruby/rubygems#5864
- We need to fix incorrect information and rewrite it for readability.