Improved the docs for the upgrade mechanism