Document hook names in hook interfaces.

Bug: T258665
Change-Id: Ifddbf57f8aa2e3eb0d5845601376cbafa08ed407

6 files changed, 18 insertions, 0 deletions

diff --git a/includes/upload/Hook/IsUploadAllowedFromUrlHook.php b/includes/upload/Hook/IsUploadAllowedFromUrlHook.php
index f078b39b1e48..c888d3bb5983 100644
--- a/includes/upload/Hook/IsUploadAllowedFromUrlHook.php
+++ b/includes/upload/Hook/IsUploadAllowedFromUrlHook.php
@@ -3,6 +3,9 @@
 namespace MediaWiki\Hook;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "IsUploadAllowedFromUrl" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */
diff --git a/includes/upload/Hook/UploadCompleteHook.php b/includes/upload/Hook/UploadCompleteHook.php
index 1377a47b5dee..bfa224c43d10 100644
--- a/includes/upload/Hook/UploadCompleteHook.php
+++ b/includes/upload/Hook/UploadCompleteHook.php
@@ -5,6 +5,9 @@ namespace MediaWiki\Hook;
 use UploadBase;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "UploadComplete" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */
diff --git a/includes/upload/Hook/UploadCreateFromRequestHook.php b/includes/upload/Hook/UploadCreateFromRequestHook.php
index 0532070c9244..9137de936265 100644
--- a/includes/upload/Hook/UploadCreateFromRequestHook.php
+++ b/includes/upload/Hook/UploadCreateFromRequestHook.php
@@ -3,6 +3,9 @@
 namespace MediaWiki\Hook;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "UploadCreateFromRequest" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */
diff --git a/includes/upload/Hook/UploadStashFileHook.php b/includes/upload/Hook/UploadStashFileHook.php
index 52e6227adc08..9522d4acdd2d 100644
--- a/includes/upload/Hook/UploadStashFileHook.php
+++ b/includes/upload/Hook/UploadStashFileHook.php
@@ -7,6 +7,9 @@ use UploadBase;
 use User;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "UploadStashFile" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */
diff --git a/includes/upload/Hook/UploadVerifyFileHook.php b/includes/upload/Hook/UploadVerifyFileHook.php
index 69f250d01e27..13379746e35e 100644
--- a/includes/upload/Hook/UploadVerifyFileHook.php
+++ b/includes/upload/Hook/UploadVerifyFileHook.php
@@ -6,6 +6,9 @@ use MessageSpecifier;
 use UploadBase;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "UploadVerifyFile" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */
diff --git a/includes/upload/Hook/UploadVerifyUploadHook.php b/includes/upload/Hook/UploadVerifyUploadHook.php
index 67b228959bca..1c407fc28114 100644
--- a/includes/upload/Hook/UploadVerifyUploadHook.php
+++ b/includes/upload/Hook/UploadVerifyUploadHook.php
@@ -7,6 +7,9 @@ use UploadBase;
 use User;
 
 /**
+ * This is a hook handler interface, see docs/Hooks.md.
+ * Use the hook name "UploadVerifyUpload" to register handlers implementing this interface.
+ *
  * @stable to implement
  * @ingroup Hooks
  */