diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index cbbdc01175f..811a4d741f4 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -95,6 +95,8 @@ information provided here is intended especially for developers.
   can call $mform->setForceLtr($elementName, true/false) on some form fields to manually
   set the value.
 * Action menus do_not_enhance() is deprecated, use a list of action_icon instead.
+* The user_not_fully_set_up() function has a new $strict parameter (defaulting to true) in order to decide when
+  custom fields (and other checks) should be evaluated to determine if the user has been completely setup.
 
 === 3.1 ===