Add function documentation to private functions

Bug: T330644
Depends-On: I2914498869ee8dbee20ca8196ac70b7b70e83b44
Depends-On: I69fb434d5840af45977d0fbc8026faab274e3866
Depends-On: I9db4e5fa87a6d84300c5f9f4e3eddf497ec31739
Change-Id: I1c42b94b1b6683b78b2b4d326bdbecc3353935d3

Author: umherirrender

src/Deserializers/AliasGroupListDeserializer.php

@@ -71,6 +71,10 @@ private function deserializeAliasGroup( array $serialization, $languageCode ) {
 		return new AliasGroup( (string)$languageCode, $aliases );
 	}
 
+	/**
+	 * @param array $serialization
+	 * @param string $requestedLanguage
+	 */
 	private function assertIsValidAliasSerialization( $serialization, $requestedLanguage ) {
 		if ( !is_array( $serialization ) ) {
 			throw new DeserializationException( 'Term serializations must be arrays' );
@@ -86,6 +90,10 @@ private function assertIsValidAliasSerialization( $serialization, $requestedLang
 		$this->assertRequestedAndActualLanguageMatch( $serialization, $requestedLanguage );
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $attributeName
+	 */
 	private function requireAttribute( array $array, $attributeName ) {
 		if ( !array_key_exists( $attributeName, $array ) ) {
 			throw new MissingAttributeException(
@@ -94,6 +102,10 @@ private function requireAttribute( array $array, $attributeName ) {
 		}
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $key
+	 */
 	private function assertNotAttribute( array $array, $key ) {
 		if ( array_key_exists( $key, $array ) ) {
 			throw new InvalidAttributeException(
@@ -104,6 +116,10 @@ private function assertNotAttribute( array $array, $key ) {
 		}
 	}
 
+	/**
+	 * @param array $serialization
+	 * @param string $requestedLanguage
+	 */
 	private function assertRequestedAndActualLanguageMatch(
 		array $serialization,
 		$requestedLanguage
@@ -117,10 +133,19 @@ private function assertRequestedAndActualLanguageMatch(
 		}
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $attributeName
+	 */
 	private function assertAttributeIsArray( array $array, $attributeName ) {
 		$this->assertAttributeInternalType( $array, $attributeName, 'array' );
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $attributeName
+	 * @param string $internalType
+	 */
 	private function assertAttributeInternalType( array $array, $attributeName, $internalType ) {
 		if ( gettype( $array[$attributeName] ) !== $internalType ) {
 			throw new InvalidAttributeException(

src/Deserializers/ReferenceDeserializer.php

@@ -37,6 +37,9 @@ public function isDeserializerFor( $serialization ) {
 		return $this->isValidSerialization( $serialization );
 	}
 
+	/**
+	 * @param mixed $serialization
+	 */
 	private function isValidSerialization( $serialization ): bool {
 		return is_array( $serialization ) && array_key_exists( 'snaks', $serialization );
 	}

src/Deserializers/SiteLinkDeserializer.php

@@ -66,6 +66,9 @@ private function getDeserializeBadges( array $serialization ): array {
 		return $badges;
 	}
 
+	/**
+	 * @param string $serialization
+	 */
 	private function deserializeItemId( $serialization ): ItemId {
 		$itemId = $this->entityIdDeserializer->deserialize( $serialization );
 
@@ -80,6 +83,9 @@ private function deserializeItemId( $serialization ): ItemId {
 		return $itemId;
 	}
 
+	/**
+	 * @param array $serialization
+	 */
 	private function assertBadgesIsArray( $serialization ) {
 		if ( !is_array( $serialization['badges'] ) ) {
 			throw new InvalidAttributeException(
@@ -90,11 +96,18 @@ private function assertBadgesIsArray( $serialization ) {
 		}
 	}
 
+	/**
+	 * @param array $serialization
+	 */
 	private function assertCanDeserialize( $serialization ) {
 		$this->requireAttribute( $serialization, 'site' );
 		$this->requireAttribute( $serialization, 'title' );
 	}
 
+	/**
+	 * @param array $serialization
+	 * @param string $attribute
+	 */
 	private function requireAttribute( $serialization, $attribute ) {
 		if ( !is_array( $serialization ) || !array_key_exists( $attribute, $serialization ) ) {
 			throw new MissingAttributeException( $attribute );

src/Deserializers/SnakDeserializer.php

@@ -137,6 +137,9 @@ private function deserializeDataValue( PropertyId $propertyId, array $serializat
 		}
 	}
 
+	/**
+	 * @param array $serialization
+	 */
 	private function assertValidDataValue( $serialization ): void {
 		if ( !is_array( $serialization ) || !array_key_exists( DataValueDeserializer::TYPE_KEY, $serialization ) ) {
 			throw new MissingTypeException( 'Not an array or missing the key "' . DataValueDeserializer::TYPE_KEY . '"' );
@@ -184,6 +187,9 @@ private function deserializePropertyId( string $serialization ): PropertyId {
 		);
 	}
 
+	/**
+	 * @param array $serialization
+	 */
 	private function assertCanDeserialize( $serialization ): void {
 		if ( !is_array( $serialization ) ) {
 			throw new DeserializationException( 'The snak serialization should be an array' );

src/Deserializers/TermDeserializer.php

@@ -55,6 +55,10 @@ private function assertCanDeserialize( $serialization ) {
 		$this->assertAttributeIsString( $serialization, 'value' );
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $attributeName
+	 */
 	private function assertAttributeIsString( array $array, $attributeName ) {
 		if ( !is_string( $array[$attributeName] ) ) {
 			throw new InvalidAttributeException(

src/Deserializers/TermListDeserializer.php

@@ -62,6 +62,10 @@ private function getDeserialized( array $serialization ) {
 		return $termList;
 	}
 
+	/**
+	 * @param array $serialization
+	 * @param string $requestedLanguage
+	 */
 	private function assertRequestedAndActualLanguageMatch(
 		array $serialization,
 		$requestedLanguage
@@ -75,6 +79,10 @@ private function assertRequestedAndActualLanguageMatch(
 		}
 	}
 
+	/**
+	 * @param array $array
+	 * @param string $attributeName
+	 */
 	private function assertAttributeIsArray( array $array, $attributeName ) {
 		if ( !is_array( $array[$attributeName] ) ) {
 			throw new InvalidAttributeException(

src/Serializers/AliasGroupListSerializer.php

@@ -33,6 +33,9 @@ public function serialize( $object ) {
 		return $this->serializeMap( $this->generateSerializedArrayRepresentation( $object ) );
 	}
 
+	/**
+	 * @param AliasGroupList $object
+	 */
 	private function assertIsSerializerFor( $object ) {
 		if ( !( $object instanceof AliasGroupList ) ) {
 			throw new UnsupportedObjectException(

src/Serializers/AliasGroupSerializer.php

@@ -27,6 +27,9 @@ public function serialize( $object ) {
 		return $this->getSerialized( $object );
 	}
 
+	/**
+	 * @param AliasGroup $object
+	 */
 	private function assertIsSerializerFor( $object ) {
 		if ( !( $object instanceof AliasGroup ) ) {
 			throw new UnsupportedObjectException(

src/Serializers/TermListSerializer.php

@@ -37,6 +37,9 @@ public function serialize( $object ) {
 		return $this->serializeMap( $this->generateSerializedArrayRepresentation( $object ) );
 	}
 
+	/**
+	 * @param TermList $object
+	 */
 	private function assertIsSerializerFor( $object ) {
 		if ( !( $object instanceof TermList ) ) {
 			throw new UnsupportedObjectException(

src/Serializers/TermSerializer.php

@@ -25,6 +25,9 @@ public function serialize( $object ) {
 		return $this->getSerialized( $object );
 	}
 
+	/**
+	 * @param Term $object
+	 */
 	private function assertIsSerializerFor( $object ) {
 		if ( !( $object instanceof Term ) ) {
 			throw new UnsupportedObjectException(