documenting the upgrade