notes on migrating from 2 to 3