Every single backwards incompatible change needs to be documented clearly. In Sphinx there's a directive specifically to indicate changes that occur between versions which should be used to reflect this. Also, the CHANGES logfile needs to reflect very clearly the large backwards incompatible change being done here.