first draft of cleaned updgrade.markdown