Fix phpdocumentor - inheritdoc imports long description only

Author: Thundar

app/code/Magento/Customer/Model/Address.php

@@ -122,6 +122,8 @@ public function __construct(
     }
 
     /**
+     * Initialize address model
+     *
      * @return void
      */
     protected function _construct()
@@ -168,7 +170,14 @@ public function updateData(AddressInterface $address)
     }
 
     /**
-     * {@inheritdoc}
+     * Create address data object based on current address model.
+     *
+     * @param int|null $defaultBillingAddressId
+     * @param int|null $defaultShippingAddressId
+     * @return AddressInterface
+     * Use Api/Data/AddressInterface as a result of service operations. Don't rely on the model to provide
+     * the instance of Api/Data/AddressInterface
+     * @SuppressWarnings(PHPMD.CyclomaticComplexity)
      */
     public function getDataModel($defaultBillingAddressId = null, $defaultShippingAddressId = null)
     {
@@ -261,6 +270,8 @@ public function getDefaultAttributeCodes()
     }
 
     /**
+     * Clone address
+     *
      * @return void
      */
     public function __clone()
@@ -301,6 +312,8 @@ public function setRegionId($regionId)
     }
 
     /**
+     * Create Customer from Factory
+     *
      * @return Customer
      */
     protected function _createCustomer()
@@ -356,7 +369,11 @@ public function reindex()
     }
 
     /**
+     * Get a list of custom attribute codes.
+     *
      * {@inheritdoc}
+     *
+     * @return string[]
      * @since 100.0.6
      */
     protected function getCustomAttributesCodes()
@@ -366,6 +383,7 @@ protected function getCustomAttributesCodes()
 
     /**
      * Get new AttributeList dependency for application code.
+     *
      * @return \Magento\Customer\Model\Address\CustomAttributeListInterface
      * @deprecated 100.0.6
      */

app/code/Magento/Customer/Model/Customer.php

@@ -1292,6 +1292,8 @@ public function getResetPasswordLinkExpirationPeriod()
     }
 
     /**
+     * Create Address from Factory
+     *
      * @return Address
      */
     protected function _createAddressInstance()
@@ -1300,6 +1302,8 @@ protected function _createAddressInstance()
     }
 
     /**
+     * Create Address Collection from Factory
+     *
      * @return \Magento\Customer\Model\ResourceModel\Address\Collection
      */
     protected function _createAddressCollection()
@@ -1308,6 +1312,8 @@ protected function _createAddressCollection()
     }
 
     /**
+     * Get Template Types
+     *
      * @return array
      */
     protected function getTemplateTypes()

app/code/Magento/Customer/Model/ResourceModel/CustomerRepository.php

@@ -161,7 +161,14 @@ public function __construct(
     }
 
     /**
-     * {@inheritdoc}
+     * Create or update a customer.
+     *
+     * @param \Magento\Customer\Api\Data\CustomerInterface $customer
+     * @param string $passwordHash
+     * @return \Magento\Customer\Api\Data\CustomerInterface
+     * @throws \Magento\Framework\Exception\InputException If bad input is provided
+     * @throws \Magento\Framework\Exception\State\InputMismatchException If the provided email is already used
+     * @throws \Magento\Framework\Exception\LocalizedException
      * @SuppressWarnings(PHPMD.CyclomaticComplexity)
      * @SuppressWarnings(PHPMD.NPathComplexity)
      */
@@ -293,7 +300,13 @@ private function populateCustomerWithSecureData($customerModel, $passwordHash =
     }
 
     /**
-     * {@inheritdoc}
+     * Retrieve customer.
+     *
+     * @param string $email
+     * @param int|null $websiteId
+     * @return \Magento\Customer\Api\Data\CustomerInterface
+     * @throws \Magento\Framework\Exception\NoSuchEntityException If customer with the specified email does not exist.
+     * @throws \Magento\Framework\Exception\LocalizedException
      */
     public function get($email, $websiteId = null)
     {
@@ -302,7 +315,12 @@ public function get($email, $websiteId = null)
     }
 
     /**
-     * {@inheritdoc}
+     * Get customer by Customer ID.
+     *
+     * @param int $customerId
+     * @return \Magento\Customer\Api\Data\CustomerInterface
+     * @throws \Magento\Framework\Exception\NoSuchEntityException If customer with the specified ID does not exist.
+     * @throws \Magento\Framework\Exception\LocalizedException
      */
     public function getById($customerId)
     {
@@ -311,7 +329,13 @@ public function getById($customerId)
     }
 
     /**
+     * Retrieve customers which match a specified criteria.
+     *
      * {@inheritdoc}
+     *
+     * @param \Magento\Framework\Api\SearchCriteriaInterface $searchCriteria
+     * @return \Magento\Customer\Api\Data\CustomerSearchResultsInterface
+     * @throws \Magento\Framework\Exception\LocalizedException
      */
     public function getList(SearchCriteriaInterface $searchCriteria)
     {
@@ -351,15 +375,24 @@ public function getList(SearchCriteriaInterface $searchCriteria)
     }
 
     /**
-     * {@inheritdoc}
+     * Delete customer.
+     *
+     * @param \Magento\Customer\Api\Data\CustomerInterface $customer
+     * @return bool true on success
+     * @throws \Magento\Framework\Exception\LocalizedException
      */
     public function delete(CustomerInterface $customer)
     {
         return $this->deleteById($customer->getId());
     }
 
     /**
-     * {@inheritdoc}
+     * Delete customer by Customer ID.
+     *
+     * @param int $customerId
+     * @return bool true on success
+     * @throws \Magento\Framework\Exception\NoSuchEntityException
+     * @throws \Magento\Framework\Exception\LocalizedException
      */
     public function deleteById($customerId)
     {