added migration docs and examples for core API