diff --git a/docs/3.0-migration-guide.md b/docs/3.0-migration-guide.md
index b345b9ddd..a6b71f643 100644
--- a/docs/3.0-migration-guide.md
+++ b/docs/3.0-migration-guide.md
@@ -175,9 +175,9 @@ number of Miller-Rabin rounds.
 
 ### Deprecated functions were removed from DRBGs
 
-The functions `mbedtls_ctr_drbg_update()` and `mbedtls_hmac_drbg_update()`
-were removed. They were superseded by `mbedtls_ctr_drbg_update_ret()` and
-`mbedtls_hmac_drbg_update_ret()` respectively.
+The functions `mbedtls_ctr_drbg_update_ret()` and `mbedtls_hmac_drbg_update_ret()`
+were renamed to replace the corresponding functions without `_ret` appended. Please call
+the name without `_ret` appended and check the return value.
 
 ### Deprecated hex-encoded primes were removed from DHM