Fix and enable FunctionComment.MissingReturn PHPCS rule

It looks like this is worth it. There are not that many issues
found, which implies that almost all of this codebase was already
following this rule.

I tried to apply the most minimal fixes as well as reduce
duplication by utilizing the @inheritdoc feature. It effectively
marks a method as "intentionally undocumented".

Change-Id: I394ad1fc9b918b0b7896bb47d60723587e174f83

Author: thiemowmde

tests/unit/NewItem.php

@@ -31,7 +31,7 @@ class NewItem {
 	private $descriptions = [];
 
 	/**
-	 * @var array[] Indexed by language on the first level
+	 * @var array<string,string[]> Indexed by language code on the first level
 	 */
 	private $aliases = [];
 
@@ -86,15 +86,15 @@ public function build() {
 	}
 
 	/**
-	 * @see andId
+	 * @param ItemId|string $itemId
+	 * @return self
 	 */
 	public static function withId( $itemId ) {
 		return ( new self() )->andId( $itemId );
 	}
 
 	/**
 	 * @param ItemId|string $itemId
-	 *
 	 * @return self
 	 */
 	public function andId( $itemId ) {
@@ -107,7 +107,9 @@ public function andId( $itemId ) {
 	}
 
 	/**
-	 * @see andLabel
+	 * @param string $languageCode
+	 * @param string $label
+	 * @return self
 	 */
 	public static function withLabel( $languageCode, $label ) {
 		return ( new self() )->andLabel( $languageCode, $label );
@@ -116,7 +118,6 @@ public static function withLabel( $languageCode, $label ) {
 	/**
 	 * @param string $languageCode
 	 * @param string $label
-	 *
 	 * @return self
 	 */
 	public function andLabel( $languageCode, $label ) {
@@ -126,7 +127,9 @@ public function andLabel( $languageCode, $label ) {
 	}
 
 	/**
-	 * @see andDescription
+	 * @param string $languageCode
+	 * @param string $description
+	 * @return self
 	 */
 	public static function withDescription( $languageCode, $description ) {
 		return ( new self() )->andDescription( $languageCode, $description );
@@ -135,7 +138,6 @@ public static function withDescription( $languageCode, $description ) {
 	/**
 	 * @param string $languageCode
 	 * @param string $description
-	 *
 	 * @return self
 	 */
 	public function andDescription( $languageCode, $description ) {
@@ -145,7 +147,9 @@ public function andDescription( $languageCode, $description ) {
 	}
 
 	/**
-	 * @see andAliases
+	 * @param string $languageCode
+	 * @param string[]|string $aliases
+	 * @return self
 	 */
 	public static function withAliases( $languageCode, $aliases ) {
 		return ( new self() )->andAliases( $languageCode, $aliases );
@@ -154,7 +158,6 @@ public static function withAliases( $languageCode, $aliases ) {
 	/**
 	 * @param string $languageCode
 	 * @param string[]|string $aliases
-	 *
 	 * @return self
 	 */
 	public function andAliases( $languageCode, $aliases ) {
@@ -164,7 +167,11 @@ public function andAliases( $languageCode, $aliases ) {
 	}
 
 	/**
-	 * @see andSiteLink
+	 * @param string $siteId
+	 * @param string $pageName
+	 * @param ItemId[]|string[]|ItemId|string|null $badges Zero or more item ID references as either
+	 *  strings or ItemId objects. Can be an array or a single value.
+	 * @return self
 	 */
 	public static function withSiteLink( $siteId, $pageName, $badges = null ) {
 		return ( new self() )->andSiteLink( $siteId, $pageName, $badges );
@@ -175,7 +182,6 @@ public static function withSiteLink( $siteId, $pageName, $badges = null ) {
 	 * @param string $pageName
 	 * @param ItemId[]|string[]|ItemId|string|null $badges Zero or more item ID references as either
 	 *  strings or ItemId objects. Can be an array or a single value.
-	 *
 	 * @return self
 	 */
 	public function andSiteLink( $siteId, $pageName, $badges = null ) {
@@ -190,15 +196,15 @@ public function andSiteLink( $siteId, $pageName, $badges = null ) {
 	}
 
 	/**
-	 * @see andStatement
+	 * @param NewStatement|Statement|Snak $statement
+	 * @return self
 	 */
 	public static function withStatement( $statement ) {
 		return ( new self() )->andStatement( $statement );
 	}
 
 	/**
 	 * @param NewStatement|Statement|Snak $statement
-	 *
 	 * @return self
 	 */
 	public function andStatement( $statement ) {