migration guide improved

Docs added.