upgrade guide improvement