more explicit instructions for migrating away from deprecated things