Update the upgrade section, synchronized with the doc/UPGRADE document in the stable and devel code branches. If you make changes to that section in the future, please remember to also update those to documents as well.