Initial draft of api-migration doc
updates to api migration doc