fix bad var name
docstrings and improved logging for upgrade test