Docs: improvements on upgrade docs