More fixes

Author: mnocon

docs/ai_actions/extend_ai_actions.md

@@ -233,7 +233,7 @@ An example Action Handler combines the input data and the Action Type options an
 The language of the transcribed data is extracted from the Runtime Context for better results.
 The Action Type options provided in the Action Context dictate whether the timestamps will be removed before returning the result.
 
-``` php hl_lines="66-68 52-55"
+``` php hl_lines="34-37 52-55"
 [[= include_file('code_samples/ai_actions/src/AI/Handler/WhisperAudioToTextActionHandler.php') =]]
 ```
 

docs/commerce/checkout/checkout_api.md

@@ -22,7 +22,7 @@ From the developer's perspective, checkouts are referenced with an UUID identifi
 To access a single checkout, use the `CheckoutServiceInterface::getCheckout` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 32, 33) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 26, 27) =]]
 ```
 
 ## Get single checkout for specific cart
@@ -31,15 +31,15 @@ To fetch checkout for a cart that already exists, use the `CheckoutServiceInterf
 You can use it when you want to initiate the checkout process right after products are successfully added to a cart.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 26, 30) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 20, 24) =]]
 ```
 
 ## Create checkout
 
 To create a checkout, use the `CheckoutServiceInterface::createCheckout` method and provide it with a `CheckoutCreateStruct` struct that contains a `CartInterface` object.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 35, 41) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 29, 35) =]]
 ```
 
 ## Update checkout
@@ -53,13 +53,13 @@ To update the checkout, use the `CheckoutServiceInterface::updateCheckout` metho
 All data is placed in session storage.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 43, 45) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 37, 39) =]]
 ```
 
 ## Delete checkout
 
 To delete a checkout from the session, use the `CheckoutServiceInterface::deleteCheckout` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 47, 48) =]]
+[[= include_file('code_samples/api/commerce/src/Controller/CustomCheckoutController.php', 41, 42) =]]
 ```

docs/commerce/payment/extend_payment.md

@@ -94,7 +94,7 @@ When you create a payment, you can attach custom data to it, for example, you ca
 You add custom data by using the `setContext` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 80, 91) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 81, 93) =]]
 ```
 
 Then, you retrieve it with the `getContext` method:

docs/commerce/shipping_management/shipment_api.md

@@ -16,15 +16,15 @@ From the developer's perspective, shipments are referenced with a UUID identifie
 To access a single shipment by using its string identifier, use the `ShipmentService::getShipmentByIdentifier` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 73, 82) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 57, 66) =]]
 ```
 
 ### Get single shipment by id
 
 To access a single shipment by using its numerical id, use the `ShipmentService::getShipment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 61, 71) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 45, 55) =]]
 ```
 
 ## Get multiple shipments
@@ -33,15 +33,15 @@ To fetch multiple shipments, use the `ShipmentService::findShipments` method.
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 84, 103) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 68, 87) =]]
 ```
 
 ## Create shipment
 
 To create a shipment, use the `ShipmentService::createShipment` method and provide it with an `Ibexa\Contracts\Shipping\Value\ShipmentCreateStruct` object that takes two parameters, a `shippingMethod` string and a `Money` object.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 105, 119) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 89, 103) =]]
 ```
 
 ## Update shipment
@@ -51,13 +51,13 @@ You could do it to support a scenario when, for example, the shipment is process
 To update shipment information, use the `ShipmentService::updateShipment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 121, 132) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 105, 116) =]]
 ```
 ## Delete shipment
 
 To delete a shipment from the system, use the `ShipmentService::deleteShipment` method:
 
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 134, 135) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShipmentCommand.php', 118, 119) =]]
 ```

docs/commerce/shipping_management/shipping_method_api.md

@@ -17,7 +17,7 @@ To access a shipping method by using its identifier, use the `ShippingMethodServ
 The method takes a string as `$identifier` parameter and uses a prioritized language from SiteAccess settings unless you pass another language as `forcedLanguage`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 65, 75) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 52, 62) =]]
 ```
 
 ### Get shipping method by ID
@@ -26,7 +26,7 @@ To access a shipping method by using its ID, use the `ShippingMethodServiceInter
 The method takes a string as `$id` parameter and uses a prioritized language from SiteAccess settings unless you pass another language as `forcedLanguage`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 53, 63) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 40, 50) =]]
 ```
 
 ## Get multiple shipping methods
@@ -35,37 +35,37 @@ To fetch multiple shipping methods, use the `ShippingMethodServiceInterface::get
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 77, 95) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 64, 82) =]]
 ```
 
 ## Create shipping method
 
 To create a shipping method, use the `ShippingMethodServiceInterface::createShippingMethod` method and provide it with the `Ibexa\Contracts\Shipping\Value\ShippingMethodCreateStruct` object that you created by using the  `newShippingMethodCreateStruct` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 97, 120) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 84, 107) =]]
 ```
 
 ## Update shipping method
 
 To update a shipping method, use the `ShippingMethodServiceInterface::updateShippingMethod` method and provide it with the `Ibexa\Contracts\Shipping\Value\ShippingMethodUpdateStruct`  object that you created by using the  `newShippingMethodUpdateStruct` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 122, 137) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 109, 123) =]]
 ```
 
 ## Delete shipping method
 
 To update a shipping method, use the `ShippingMethodServiceInterface::deleteShippingMethod` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 138, 144) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 125, 131) =]]
 ```
 
 ## Delete shipping method translation
 
 To delete shipping method translation, use the `ShippingMethodServiceInterface::deleteShippingMethodTranslation` method.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 146, 155) =]]
+[[= include_file('code_samples/api/commerce/src/Command/ShippingMethodCommand.php', 133, 142) =]]
 ```

docs/content_management/data_migration/data_migration_api.md

@@ -11,21 +11,21 @@ You can use the PHP API to manage and run [data migrations](data_migration.md).
 To list all migration files available in the directory defined in configuration (by default, `src/Migrations/Ibexa`), use the `MigrationService:listMigrations()` method:
 
 ``` php
-[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 35, 38) =]]
+[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 31, 34) =]]
 ```
 
 To get a single migration file by its name, use the `MigrationService:findOneByName()` method:
 
 ``` php
-[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 40, 41) =]]
+[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 35, 36) =]]
 ```
 
 ## Running migration files
 
 To run migration file(s), use either `MigrationService:executeOne()` or `MigrationService:executeAll()`:
 
 ``` php
-[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 42, 44) =]]
+[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 38, 40) =]]
 ```
 
 Both `executeOne()` and `executeAll()` can take an optional parameter: the login of the User that you want to execute the migrations as.
@@ -35,5 +35,5 @@ Both `executeOne()` and `executeAll()` can take an optional parameter: the login
 To add a new migration file, use the `MigrationService:add()` method:
 
 ``` php
-[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 28, 34) =]]
+[[= include_file('code_samples/api/migration/src/Command/MigrationCommand.php', 24, 30) =]]
 ```

docs/pim/catalog_api.md

@@ -11,7 +11,7 @@ To get information about product catalogs and manage them, use `CatalogServiceIn
 To get a single catalog, use `Ibexa\Contracts\ProductCatalog\CatalogServiceInterface::getCatalog()` and provide it with catalog ID, or `CatalogServiceInterface::getCatalogByIdentifier()` and pass the identifier:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 81, 83) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 68, 70) =]]
 ```
 
 ## Get products in catalog
@@ -20,7 +20,7 @@ To get products from a catalog, request the product query from the catalog objec
 Then, create a new `ProductQuery` based on it and run a product search with `ProductServiceInterface::findProduct()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 85, 91) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 72, 78) =]]
 ```
 
 ## Create catalog
@@ -29,7 +29,7 @@ To create a catalog, you need to prepare a `CatalogCreateStruct` that contains:
 Then, pass this struct to `CatalogServiceInterface::createCatalog()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 71, 79) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 51, 66) =]]
 ```
 
 ## Update catalog
@@ -39,5 +39,5 @@ You must pass the catalog object and a `CatalogUpdateStruct` to the method.
 In the following example, you update the catalog to publish it:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 93, 97) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CatalogCommand.php', 80, 84) =]]
 ```

docs/pim/price_api.md

@@ -12,13 +12,13 @@ To access a currency object by its code, use `CurrencyServiceInterface::getCurre
 To access a whole list of currencies, use `CurrencyServiceInterface::findCurrencies`.
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 52, 61) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 42, 50) =]]
 ```
 
 To create a new currency, use `CurrencyServiceInterface::createCurrency()` and provide it with a `CurrencyCreateStruct` with code, number of fractional digits and a flag indicating if the currency is enabled:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 67, 71) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/CurrencyCommand.php', 57, 60) =]]
 ```
 
 ## Prices
@@ -28,34 +28,34 @@ To manage prices, use `ProductPriceService`.
 To retrieve the price of a product in the currency for the current context, use `Product::getPrice()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 79, 82) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 60, 63) =]]
 ```
 
 To retrieve the price of a product in a specific currency, use `ProductPriceService::getPriceByProductAndCurrency`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 83, 86) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 64, 67) =]]
 ```
 
 To get all prices (in different currencies) for a given product, use `ProductPriceService::findPricesByProductCode`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 97, 103) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 78, 84) =]]
 ```
 
 To load price definitions that match given criteria, use `ProductPriceServiceInterface::findPrices`:
 
 ``` php
 [[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 12, 16) =]]
 // ...
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 104, 114) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 85, 95) =]]
 ```
 
 You can also use `ProductPriceService` to create or modify existing prices.
 For example, to create a new price for a given currency, use `ProductPriceService::createProductPrice` and provide it with a `ProductPriceCreateStruct` object:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 79, 85) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 69, 75) =]]
 ```
 
 !!! note
@@ -80,7 +80,7 @@ To resolve a price of a product in the currency for the current context, use eit
 ``` php
 [[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 7, 8) =]][[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 11, 12) =]]
 // ...
-[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 115, 119) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/ProductPriceCommand.php', 96, 100) =]]
 ```
 
 ## VAT
@@ -89,17 +89,17 @@ To get information about the VAT categories and rates configured in the system,
 VAT is configured per region, so you also need to use `RegionServiceInterface` to get the relevant region object.
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 54, 55) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 41, 42) =]]
 ```
 
 To get information about all VAT categories configured for the selected region, use `VatServiceInterface::getVatCategories()`:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 56, 61) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 43, 48) =]]
 ```
 
 To get a single VAT category, use `VatServiceInterface::getVatCategoryByIdentifier()` and provide it with the region object and the identifier of the VAT category:
 
 ``` php
-[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 62, 64) =]]
+[[= include_file('code_samples/api/product_catalog/src/Command/VatCommand.php', 49, 50) =]]
 ```