document first few individual migrations
draft for connection migration