add some new sections to the API migration docs, where more detailed explanations can be provided for some of the API changes and additions