[1.7.x] Improved formatting and links of migration docs.

Backport of ab8d8e00c9 from master