diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index c410cd08166..6409b4a99e4 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -2,6 +2,8 @@ This files describes API changes in core libraries and APIs,
 information provided here is intended especially for developers.
 
 === 3.9 ===
+* 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.
 * admin/tool/task/cli/adhoc_task.php now observers the concurrency limits.
   If you want to get the previous (unlimited) behavior, use the --ignorelimits switch).
 * Removed the following deprecated functions: