EDU-11146 - Update Shipping Simulator shouldUpdateOrderForm prop (#1125)

#### What problem is this solving?

<!--- What is the motivation and context for this change? -->

#### How to test it?

<!--- Don't forget to add a link to a Workspace where this branch is
linked -->

[Workspace](Link goes here!)

#### Screenshots or example usage:

<!--- Add some images or gifs to showcase changes in behaviour or
layout. Example: before and after images -->

#### Describe alternatives you've considered, if any.

<!--- Optional -->

#### Related to / Depends on

<!--- Optional -->

#### How does this PR make you feel? [:link:](http://giphy.com/)

<!-- Go to http://giphy.com/ and pick a gif that represents how this PR
makes you feel -->

![](put .gif link here - can be found under "advanced" on giphy)

CHANGELOG.md

@@ -13,6 +13,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Default selection logic in `SKU Selector` component to prioritize available SKUs.
 
+### Fixed
+
+- Updating the `shouldUpdateOrderForm` prop description.
+
 ## [3.175.1] - 2024-09-11
 
 ### Fixed

docs/ShippingSimulator.md

@@ -2,13 +2,13 @@
 
 # Shipping Simulator
 
-The `shipping-simulator` block estimates the shipping fee based on a zip code input.
+The `shipping-simulator` block estimates the shipping cost based on a postal code input.
 
 ![shipping](https://user-images.githubusercontent.com/52087100/70262606-6ddb7c00-1773-11ea-91af-ededfd27aa95.png)
 
 ## Configuration
 
-1. Import the `vtex.store-components` app to your theme's dependencies in the `manifest.json` file as in the following example:
+1. Import the `vtex.store-components` app to your theme's dependencies in the `manifest.json` file, as shown in the following example:
 
 ```json
   "dependencies": {
@@ -31,7 +31,7 @@ The `shipping-simulator` block estimates the shipping fee based on a zip code in
   },
 ```
 
-3. Then, declare the `shipping-simulator` block using the props stated in the [Props](#props) table. For example:
+3. Declare the `shipping-simulator` block using the props stated in the [Props](#props) table. For example:
 
 ```json
    "shipping-simulator": {
@@ -45,14 +45,14 @@ The `shipping-simulator` block estimates the shipping fee based on a zip code in
 
 | Prop name               | Type      | Description                                                                                   | Default value |
 | ----------------------- | --------- | --------------------------------------------------------------------------------------------- | ------------- |
-| `pricingMode`           | `enum`    | If the product has gifts or attachments, for example, you can choose whether the shipping information will be grouped (`grouped`) by shipping type or showing the shipping prices for each of the items individually (`individualItems`). | `individualItems`       |
+| `pricingMode`           | `enum`    | Defines how shipping information is displayed when a product includes gifts or attachments. You can choose to group shipping information by type (`grouped`) or display shipping costs for each item individually (`individualItems`). | `individualItems`       |
 | `seller`                | `String`  | ID of the product seller.                                                                      | -             |
-| `shouldUpdateOrderForm` | `Boolean` | Whether interacting with the simulator should update the shopper's address in their `orderForm`. | `true`        |
+| `shouldUpdateOrderForm` | `Boolean` | Determines whether interacting with the shipping simulator should update the shopper's address in their `orderForm` (`true`). This only works if the [orderform optimization](https://developers.vtex.com/docs/guides/vtex-io-documentation-enabling-order-form-optimization) is enabled; otherwise, it has no effect, even if set to `true`. | `true`        |
 | `skuId`                 | `String`  | ID of the current product SKU.                                                                 | -             |
 
 ## Customization
 
-To apply CSS customizations in this and other blocks, follow the [Using CSS handles for store customization](https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-documentation-using-css-handles-for-store-customization) guide.
+To apply CSS customizations to this and other blocks, see the guide[Using CSS handles for store customization](https://developers.vtex.com/vtex-developer-docs/docs/vtex-io-documentation-using-css-handles-for-store-customization).
 
 | CSS Handles                         |
 | ----------------------------------- |