first cut of upgrade guide