add migration instructions to README
various updates