I will admit that, in my case, I did not RTFM before doing the upgrade. But for my upgrade, there were ten sets of release notes to be waded through. Making a change that is certain to break customers' apps, then burying a passing comment in the release notes is not good software...