Add documentation for upgrade checks
upgrade: Fixes and cleanups from pull request