The refefence guide should have a pointer to the migration notes to make life easier to people upgrading from 4.x to 5.