updated docs about new upgrade method