diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index a7039230a41..3326bd043b3 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -122,12 +122,14 @@ information provided here is intended especially for developers.
   when building Xpath, or pass the unescaped value when using the named selector.
 * Add new file_is_executable(), to consistently check for executables even in Windows (PHP bug #41062).
 * Introduced new hooks for plugin developers.
-  * pre_course_category_delete($category)
-  * pre_course_delete($course)
-  * pre_course_module_delete($cm)
-  * pre_block_delete($instance)
-  * pre_user_delete($user)
-  These hooks allow developers to use the item in question before it is deleted by core.
+    - <component>_pre_course_category_delete($category)
+    - <component>_pre_course_delete($course)
+    - <component>_pre_course_module_delete($cm)
+    - <component>_pre_block_delete($instance)
+    - <component>_pre_user_delete($user)
+  These hooks allow developers to use the item in question before it is deleted by core. For example, if your plugin is
+  a module (plugins located in the mod folder) called 'xxx' and you wish to interact with the user object before it is
+  deleted then the function to create would be mod_xxx_pre_user_delete($user) in mod/xxx/lib.php.
 
 === 3.0 ===