Add migration docs for 1.2

resolve #97
Merge branch '1.2-docs' into dev