Create upgrade.rst

Move the migrate information from the readme file to a seperate doc article.