Small fixes in README migration file

* Rename file to README.md. This needed to correctly display file on github
* Many style fixes

Change-Id: Ic57a2184817f9df16451b8fce784585039f92d6f
Merge "Small fixes in README migration file"