YUM migration doc: add a warning about formatting issues and mention alt...

...ernate source.