More clearly document the backwards incompatible changes