upgrade.rst update and minor changes to other pages.