- add a migration note for ref #3222