Adjusments according review: add interface description and minor code changes

Author: coderimus

app/code/Magento/MediaGallery/Model/Keyword.php

@@ -38,7 +38,7 @@ public function getId(): ?int
     /**
      * @inheritdoc
      */
-    public function getKeyword() : string
+    public function getKeyword(): string
     {
         return (string)$this->getData(self::KEYWORD);
     }

app/code/Magento/MediaGallery/Plugin/Wysiwyg/Images/Storage.php

@@ -87,7 +87,10 @@ public function afterDeleteFile(StorageSubject $subject, StorageSubject $result,
         try {
             $this->deleteMediaAssetByPath->execute($relativePath);
         } catch (\Exception $exception) {
-            $message = __('An error occurred during media asset delete at wysiwyg: %1', $exception->getMessage());
+            $message = __(
+                'An error occurred during media asset delete at wysiwyg: %error',
+                ['error' => $exception->getMessage()]
+            );
             $this->logger->critical($message->render());
         }
 

app/code/Magento/MediaGalleryApi/Api/Data/AssetInterface.php

@@ -11,8 +11,8 @@
 use Magento\Framework\Api\ExtensibleDataInterface;
 
 /**
- * Asset Interface
- *
+ * Represents a media gallery asset which contains information about a media asset entity such
+ * as path to the media storage, media asset title and its content type, etc.
  */
 interface AssetInterface extends ExtensibleDataInterface
 {

app/code/Magento/MediaGalleryApi/Api/Data/KeywordInterface.php

@@ -11,7 +11,7 @@
 use Magento\Framework\Api\ExtensibleDataInterface;
 
 /**
- * Interface KeywordInterface
+ * Represents a media gallery keyword. This object contains information about a media asset keyword entity.
  */
 interface KeywordInterface extends ExtensibleDataInterface
 {

app/code/Magento/MediaGalleryApi/Model/Asset/Command/DeleteByPathInterface.php

@@ -9,7 +9,7 @@
 namespace Magento\MediaGalleryApi\Model\Asset\Command;
 
 /**
- * Interface DeleteByPathInterface
+ * A command represents the media gallery asset delete action. A media gallery asset is filtered by path value.
  */
 interface DeleteByPathInterface
 {

app/code/Magento/MediaGalleryApi/Model/Asset/Command/GetByIdInterface.php

@@ -9,7 +9,7 @@
 namespace Magento\MediaGalleryApi\Model\Asset\Command;
 
 /**
- * Interface GetByIdInterface
+ * A command represents the get media gallery asset by using media gallery asset id as a filter parameter.
  */
 interface GetByIdInterface
 {

app/code/Magento/MediaGalleryApi/Model/Asset/Command/GetByPathInterface.php

@@ -9,7 +9,7 @@
 namespace Magento\MediaGalleryApi\Model\Asset\Command;
 
 /**
- * Interface GetByPathInterface
+ * A command represents the get media gallery asset by using media gallery asset path as a filter parameter.
  */
 interface GetByPathInterface
 {

app/code/Magento/MediaGalleryApi/Model/Asset/Command/SaveInterface.php

@@ -11,7 +11,7 @@
 use Magento\MediaGalleryApi\Api\Data\AssetInterface;
 
 /**
- * Interface SaveInterface
+ * A command which executes the media gallery asset save operation.
  */
 interface SaveInterface
 {

app/code/Magento/MediaGalleryApi/Model/Keyword/Command/GetAssetKeywordsInterface.php

@@ -8,7 +8,7 @@
 namespace Magento\MediaGalleryApi\Model\Keyword\Command;
 
 /**
- * Interface GetAssetKeywordsInterface
+ * A command represents functionality to get a media gallery asset keywords filtered by media gallery asset id.
  */
 interface GetAssetKeywordsInterface
 {

app/code/Magento/MediaGalleryApi/Model/Keyword/Command/SaveAssetKeywordsInterface.php

@@ -8,7 +8,7 @@
 namespace Magento\MediaGalleryApi\Model\Keyword\Command;
 
 /**
- * Interface SaveAssetKeywordsInterface
+ * A command represents the media gallery asset keywords save operation.
  */
 interface SaveAssetKeywordsInterface
 {