docs: Hook interface doc comment review

Edited doc comments for hook interfaces to improve
consistency and add type hints.

Bug: T246855
Change-Id: I38fa802463cd6f39bf5946dbbeb1b3ebaea604b2

1 files changed, 5 insertions, 3 deletions

diff --git a/includes/Hook/GetDefaultSortkeyHook.php b/includes/Hook/GetDefaultSortkeyHook.php
index 450b4f2f40e8..8743ec3d837f 100644
--- a/includes/Hook/GetDefaultSortkeyHook.php
+++ b/includes/Hook/GetDefaultSortkeyHook.php
@@ -2,18 +2,20 @@
 
 namespace MediaWiki\Hook;
 
+use Title;
+
 /**
  * @stable for implementation
  * @ingroup Hooks
  */
 interface GetDefaultSortkeyHook {
 	/**
-	 * Override the default sortkey for a page.
+	 * Use this hook to override the default sortkey for a page.
 	 *
 	 * @since 1.35
 	 *
-	 * @param ?mixed $title Title object that we need to get a sortkey for
-	 * @param ?mixed &$sortkey Sortkey to use.
+	 * @param Title $title Title object that we need to get a sortkey for
+	 * @param string &$sortkey Sortkey to use
 	 * @return bool|void True or no return value to continue or false to abort
 	 */
 	public function onGetDefaultSortkey( $title, &$sortkey );