Added comment about getContext usage

Author: mnocon

code_samples/api/commerce/src/Command/PaymentCommand.php

@@ -72,6 +72,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $payment = $this->paymentService->getPaymentByIdentifier($paymentIdentifier);
 
         $context = $payment->getContext();
+        // Will be overridden later but used to illustrate `getContext()`
 
         $output->writeln(sprintf('Your payment for transaction has status %s', $payment->getStatus()));
 

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', 96, 108) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 97, 109) =]]
 ```
 
 Then, you retrieve it with the `getContext` method:

docs/commerce/payment/payment_api.md

@@ -34,16 +34,16 @@ To fetch multiple payments, use the `PaymentServiceInterface::findPayments` meth
 It follows the same search query pattern as other APIs:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 78, 94) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 79, 95) =]]
 ```
 
 ## Create payment
 
 To create a payment, use the `PaymentServiceInterface::createPayment` method and provide it with the `Ibexa\Contracts\Payment\Payment\PaymentCreateStruct` object that takes the following arguments: `method`, `order` and `amount`.
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 100, 104) =]]
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 107, 111) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 101, 105) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 108, 112) =]]
 ```
 
 ## Update payment
@@ -54,13 +54,13 @@ The `Ibexa\Contracts\Payment\Payment\PaymentUpdateStruct` object takes the follo
 To update payment information, use the `PaymentServiceInterface::updatePayment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 112, 118) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 113, 119) =]]
 ```
 
 ## Delete payment
 
 To delete a payment from the system, use the `PaymentServiceInterface::deletePayment` method:
 
 ``` php
-[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 120, 121) =]]
+[[= include_file('code_samples/api/commerce/src/Command/PaymentCommand.php', 121, 122) =]]
 ```