I'm wondering if it would be better to put this somewhere else in the Play documentation, and have the migration guide link to that.  Same with less.