a doc comment explaining the idea behind this migration would be helpful.