Some progress on migration development doc.  #767