update documentation for upgrade