MAGE-1154: add somme PHPdoc

Author: damcou

Service/AdditionalSection/RecordBuilder.php

@@ -13,6 +13,12 @@ public function __construct(
         protected ManagerInterface $eventManager,
     ){}
 
+    /**
+     * Builds a Section record
+     *
+     * @param DataObject $entity
+     * @return array
+     */
     public function buildRecord(DataObject $entity): array
     {
         $record = [

Service/Category/RecordBuilder.php

@@ -34,6 +34,14 @@ public function __construct(
         protected Manager                   $moduleManager,
     ) {}
 
+    /**
+     * Builds a Category record
+     *
+     * @param DataObject $entity
+     * @return array
+     * @throws AlgoliaException
+     * @throws LocalizedException
+     */
     public function buildRecord(DataObject $entity): array
     {
         if (!$entity instanceof MagentoCategory) {

Service/Page/RecordBuilder.php

@@ -22,6 +22,11 @@ public function __construct(
     ){}
 
     /**
+     * Builds a Page record
+     *
+     * @param DataObject $entity
+     * @return array
+     *
      * @throws AlgoliaException
      */
     public function buildRecord(DataObject $entity): array

Service/Product/RecordBuilder.php

@@ -3,6 +3,7 @@
 namespace Algolia\AlgoliaSearch\Service\Product;
 
 use Algolia\AlgoliaSearch\Api\RecordBuilder\RecordBuilderInterface;
+use Algolia\AlgoliaSearch\Exception\DiagnosticsException;
 use Algolia\AlgoliaSearch\Exception\ProductDeletedException;
 use Algolia\AlgoliaSearch\Exception\ProductDisabledException;
 use Algolia\AlgoliaSearch\Exception\ProductNotVisibleException;
@@ -53,6 +54,18 @@ public function __construct(
         protected StockRegistryInterface $stockRegistry,
         protected PriceManager           $priceManager,
     ){}
+
+    /**
+     * Builds a Product record
+     *
+     * @param DataObject $entity
+     * @return array
+     *
+     * @throws AlgoliaException
+     * @throws LocalizedException
+     * @throws NoSuchEntityException
+     * @throws DiagnosticsException
+     */
     public function buildRecord(DataObject $entity): array
     {
         if (!$entity instanceof Product) {

Service/Suggestion/RecordBuilder.php

@@ -13,6 +13,12 @@ public function __construct(
         protected ManagerInterface $eventManager,
     ){}
 
+    /**
+     * Builds a Suggestion record
+     *
+     * @param DataObject $entity
+     * @return array
+     */
     public function buildRecord(DataObject $entity): array
     {
         $suggestionObject = [