diff --git a/libfwupd/README.md b/libfwupd/README.md
index 263e4f0f9..48f307a15 100644
--- a/libfwupd/README.md
+++ b/libfwupd/README.md
@@ -6,3 +6,7 @@ When we next bump soname the following changes are planned:
  * {sa{sv}} -> {a{sv}} -- we don't always want to send the device ID
  * Rename FU_DEVICE_FLAG -> FWUPD_DEVICE_FLAG
  * Remove all deprecated API
+ * Rename GetDetailsLocal() -> GetDetails()
+ * Rename UpdateMetadataWithId() -> UpdateMetadata()
+ * Make DeviceAdded emit a FwupdDevice, not a FwupdResult
+ * Unexport fwupd_result_to_data() and fwupd_result_new_from_data()