Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/carts.raml

@@ -115,7 +115,7 @@ post:
     securedBy: [oauth_2_0: { scopes: ['manage_orders:{projectKey}'] }]
     description: |
       Merges items from an anonymous Cart into the most recently modified active Cart of a Customer. If no active Cart exists, the anonymous Cart becomes the Customer's active Cart.
-      For more information, see [Merge behavior](/../api/carts-orders-overview#merge-behavior).
+      For more information about merge mode behaviors, merge rules, and tax recalculation, see [Merge a Cart](/../api/carts-orders-overview#merge-a-cart).
 
     body:
       application/json:

api-specs/api/resources/in-store/carts-in-store.raml

@@ -141,7 +141,7 @@ post:
 
       If the Cart exists in the Project but does not have a `store` specified, or the `store` field references a different Store, a [ResourceNotFound](ctp:api:type:ResourceNotFoundError) error is returned.
 
-      For more information, see [Merge behavior](/../api/carts-orders-overview#merge-behavior).
+      For more information about merge mode behaviors, merge rules, and tax recalculation, see [Merge a Cart](/../api/carts-orders-overview#merge-a-cart).
 
     body:
       application/json:

api-specs/api/types/cart/CartMergeMode.raml

@@ -3,12 +3,13 @@
 displayName: CartMergeMode
 type: string
 description: |
-  Determines how to manually merge an anonymous Cart with an existing Customer Cart.
+  Determines how to manually merge an anonymous Cart with an existing Customer Cart. For more information about merge mode behaviors, merge rules, and tax recalculation, see [Merge a Cart](/../api/carts-orders-overview#merge-a-cart).
+
 enum:
   - MergeWithExistingCustomerCart
   - UseAsNewActiveCustomerCart
 (enumDescriptions):
   MergeWithExistingCustomerCart: |
-    Merges the anonymous Cart with the existing Customer Cart. Line Items from the anonymous Cart are added to the Customer Cart.
+    Merges the anonymous Cart with the existing Customer Cart.
   UseAsNewActiveCustomerCart: |
-    Uses the anonymous Cart as the new active Customer Cart, replacing the existing one.
+    Uses the anonymous Cart as the new active Customer Cart, replacing the existing one. No items from the previous active Cart are merged.

api-specs/api/types/customer/AnonymousCartSignInMode.raml

@@ -2,9 +2,15 @@
 (package): Customer
 displayName: AnonymousCartSignInMode
 type: string
+description: |
+  Determines how an anonymous Cart is handled when a Customer signs in. For more information, see [Cart merge during sign-in and sign-up](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up).
+
 enum:
   - MergeWithExistingCustomerCart
   - UseAsNewActiveCustomerCart
 (enumDescriptions):
-  MergeWithExistingCustomerCart: If set, the content of an anonymous [Cart is merged during sign-in](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) with the Customer's most recently modified active Cart.
-  UseAsNewActiveCustomerCart: If set, an anonymous Cart is used as the new active Customer Cart, and no [LineItems](ctp:api:type:LineItem) or [CustomLineItems](ctp:api:type:CustomLineItem) are merged.
+  MergeWithExistingCustomerCart: |
+    The content of an anonymous [Cart is merged during sign-in](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) with the Customer's most recently modified active Cart.
+
+  UseAsNewActiveCustomerCart: |
+    Uses the anonymous Cart as the new active Customer Cart, replacing the existing one. No items from the previous active Cart are merged.