ACQE-6372: Multishipping checkout flow with online shipping methods

Added comment in the test file to understand the each section

Author: nikhilsharma-adobe

app/code/Magento/Shipping/Test/Mftf/Test/StorefrontMultishippingCheckoutWithOnlineShippingMethodTest.xml

@@ -40,12 +40,12 @@
             <actionGroup ref="LoginToStorefrontActionGroup" stepKey="loginToStorefrontAccount">
                 <argument name="Customer" value="$customer$"/>
             </actionGroup>
-                <actionGroup ref="CliCacheCleanActionGroup" stepKey="cleanInvalidatedCaches">
-                    <argument name="tags" value="config full_page"/>
-                </actionGroup>
-                <actionGroup ref="CliIndexerReindexActionGroup" stepKey="reindexPostChangingConfigurationSettings">
-                    <argument name="indices" value="cataloginventory_stock catalog_product_price"/>
-                </actionGroup>
+            <actionGroup ref="CliCacheCleanActionGroup" stepKey="cleanInvalidatedCaches">
+                <argument name="tags" value="config full_page"/>
+            </actionGroup>
+            <actionGroup ref="CliIndexerReindexActionGroup" stepKey="reindexPostChangingConfigurationSettings">
+                <argument name="indices" value="cataloginventory_stock catalog_product_price"/>
+            </actionGroup>
             <!-- Open product page through category -->
             <actionGroup ref="StorefrontOpenProductPageActionGroup" stepKey="waitForSimpleProductPage">
                 <argument name="productUrl" value="$$product.custom_attributes[url_key]$$"/>
@@ -63,29 +63,37 @@
                 <argument name="addressOption1" value="3"/>
                 <argument name="addressOption2" value="4"/>
             </actionGroup>
+            <!-- Updating the address for shipping section -->
             <waitForElementClickable selector="{{SingleShippingSection.updateAddress}}" stepKey="waitForUpdateAddress"/>
             <click selector="{{SingleShippingSection.updateAddress}}" after="waitForUpdateAddress" stepKey="clickUpdateAddress"/>
             <waitForPageLoad after="clickUpdateAddress" stepKey="waitForClickOnUpdateAddress"/>
             <waitForElementClickable selector="{{AdminShipmentAddressInformationSection.goToShippingInformation}}" stepKey="waitForClickGoToShippingInformation"/>
             <click selector="{{AdminShipmentAddressInformationSection.goToShippingInformation}}" stepKey="clickGoToShippingInformation"/>
             <waitForPageLoad after="clickGoToShippingInformation" stepKey="waitForShippingInformation"/>
+            <!-- Selecting shipping method based on the address -->
             <waitForElementClickable selector="{{AdminShipmentAddressInformationSection.selectShippingMethodBasedOnAddress('Culver City', 'Federal Express', 'Ground')}}" stepKey="waitForSelectShippingMethodBasedOnAddress"/>
             <click selector="{{AdminShipmentAddressInformationSection.selectShippingMethodBasedOnAddress('Culver City', 'Federal Express', 'Ground')}}" stepKey="clickToSelectFederalExpressMethod"/>
             <click selector="{{AdminShipmentAddressInformationSection.selectShippingMethodBasedOnAddress('Germany', 'DHL', 'Express easy')}}" stepKey="clickToSelectDHLMethod"/>
             <click selector="{{AdminShipmentAddressInformationSection.selectShippingMethodBasedOnAddress('London', 'United Parcel Service', 'UPS Worldwide Expedited')}}" stepKey="clickToSelectUPSMethod"/>
             <click selector="{{AdminShipmentAddressInformationSection.selectShippingMethodBasedOnAddress('New York', 'United States Postal Service', 'Library Mail Parcel')}}" stepKey="clickToSelectUSPSMethod"/>
+            <!-- Click on the billing information button to save selected data -->
             <waitForElementClickable selector="{{AdminShipmentAddressInformationSection.goToBillingInfo}}" stepKey="waitForGoToBillingInfoButton"/>
             <click selector="{{AdminShipmentAddressInformationSection.goToBillingInfo}}" stepKey="goToBillingInformation"/>
+            <!-- Select check money payment method -->
             <actionGroup ref="CheckoutSelectCheckMoneyOrderPaymentActionGroup" stepKey="selectPaymentMethod"/>
+            <!-- Go to review order page -->
             <waitForElementClickable selector="{{AdminShipmentAddressInformationSection.goToReviewOrder}}" stepKey="waitForGoToReviewOrder"/>
             <click selector="{{AdminShipmentAddressInformationSection.goToReviewOrder}}" stepKey="goToReviewOrder"/>
+            <!-- Verify the address/shipping data before place order -->
             <waitForElementVisible selector="{{AdminShipmentAddressInformationSection.reviewOrderInfo('Culver City', 'Ground')}}" stepKey="waitForFirstProductReviewOrderInformation"/>
             <waitForElementVisible selector="{{AdminShipmentAddressInformationSection.reviewOrderInfo('Germany', 'Express easy')}}" stepKey="waitForSecondProductReviewOrderInformation"/>
             <waitForElementVisible selector="{{AdminShipmentAddressInformationSection.reviewOrderInfo('London', 'UPS Worldwide Expedited')}}" stepKey="waitForThirdProductReviewOrderInformation"/>
             <waitForElementVisible selector="{{AdminShipmentAddressInformationSection.reviewOrderInfo('New York', 'Library Mail Parcel')}}" stepKey="waitForFourthProductReviewOrderInformation"/>
             <waitForElementClickable selector="{{AdminShipmentAddressInformationSection.placeOrder}}" stepKey="waitForPlaceOrder"/>
+            <!-- Place order and verify success message -->
             <click selector="{{AdminShipmentAddressInformationSection.placeOrder}}" stepKey="placeOrder"/>
             <waitForText selector="{{AdminShipmentAddressInformationSection.successTitle}}" userInput="Thank you for your purchase!" stepKey="waitForLoadSuccessPage"/>
+            <!-- Grabbing order number and open order info page -->
             <grabTextFrom selector="{{AdminShipmentAddressInformationSection.multiCheckoutOrderId('1')}}" stepKey="grabOrderIdForFirstOrder"/>
             <executeJS function="var orderID = '{$grabOrderIdForFirstOrder}'.replace(/\D|^0+/g, ''); return (orderID);" stepKey="firstOrderID"/>
             <grabTextFrom selector="{{AdminShipmentAddressInformationSection.multiCheckoutOrderId('2')}}" stepKey="grabOrderIdForSecondOrder"/>