diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index 9ea25900d87..5958b086ccd 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -2,7 +2,9 @@ This files describes API changes in core libraries and APIs,
 information provided here is intended especially for developers.
 
 === 3.8.1 ===
-format_float() now accepts a special value (-1) as the $decimalpoints parameter which means auto-detecting number of decimal points.
+* behat_data_generators::the_following_exist() has been removed, please use
+  behat_data_generators::the_following_entities_exist() instead. See MDL-67691 for more info.
+* format_float() now accepts a special value (-1) as the $decimalpoints parameter which means auto-detecting number of decimal points.
 
 === 3.8 ===
 * The rotate_image function has been added to the stored_file class (MDL-63349)