diff --git a/app/code/Magento/Catalog/Model/Product/Gallery/CreateHandler.php b/app/code/Magento/Catalog/Model/Product/Gallery/CreateHandler.php
index aaf6a5a8b79b0b4988bc1b3caad56ff3ffa2dd66..cbf0464ca366158d4d3e4d75f65e4435f0834502 100644
--- a/app/code/Magento/Catalog/Model/Product/Gallery/CreateHandler.php
+++ b/app/code/Magento/Catalog/Model/Product/Gallery/CreateHandler.php
@@ -58,7 +58,9 @@ class CreateHandler implements ExtensionInterface
      */
     protected $fileStorageDb;
 
-    /** @var  array */
+    /**
+     * @var array
+     */
     private $mediaAttributeCodes;
 
     /**
diff --git a/app/code/Magento/Catalog/Model/ResourceModel/Product/Link.php b/app/code/Magento/Catalog/Model/ResourceModel/Product/Link.php
index 2af9b51fde9698f6447b0b187033c535435d3679..17bfa90e8842d4dc511d8d78f2dc23151a3934b3 100644
--- a/app/code/Magento/Catalog/Model/ResourceModel/Product/Link.php
+++ b/app/code/Magento/Catalog/Model/ResourceModel/Product/Link.php
@@ -97,10 +97,10 @@ class Link extends \Magento\Framework\Model\ResourceModel\Db\AbstractDb
     }
 
     /**
-     * Is product has links
+     * Check if product has links.
      *
-     * @param int $parentId
-     * @return int
+     * @param int $parentId ID of product
+     * @return bool
      */
     public function hasProductLinks($parentId)
     {
diff --git a/app/code/Magento/CatalogInventory/Model/Stock/StockItemRepository.php b/app/code/Magento/CatalogInventory/Model/Stock/StockItemRepository.php
index 19d5f8e90432b6ab9e84d6aa384ff5e6335efc78..58e364920bb6ad4919212ba329e2d8294cd36027 100644
--- a/app/code/Magento/CatalogInventory/Model/Stock/StockItemRepository.php
+++ b/app/code/Magento/CatalogInventory/Model/Stock/StockItemRepository.php
@@ -134,6 +134,7 @@ class StockItemRepository implements StockItemRepositoryInterface
     }
 
     /**
+     * @deprecated
      * @return  \Magento\Catalog\Model\ResourceModel\Product\CollectionFactory
      */
     private function getProductCollectionFactory()
diff --git a/app/code/Magento/Eav/Model/ResourceModel/AttributeLoader.php b/app/code/Magento/Eav/Model/ResourceModel/AttributeLoader.php
index e2c2b7d0275a2f05f8e22acfdde730ff915d0d1c..439f550a2bf020fadd8ae18abfb2348f4b18cf6b 100644
--- a/app/code/Magento/Eav/Model/ResourceModel/AttributeLoader.php
+++ b/app/code/Magento/Eav/Model/ResourceModel/AttributeLoader.php
@@ -11,7 +11,9 @@ use Magento\Framework\Api\SearchCriteriaBuilder;
 use Magento\Framework\EntityManager\MetadataPool;
 
 /**
- * Class load and cache attributes from some attribute set
+ * Сlass responsible for loading and caching of attributes related to the given attribute set.
+ *
+ * Can be used to improve performance of services that mostly read attribute data.
  */
 class AttributeLoader
 {