chore(oas): [20/n] improve oas schemas (#9337)

Improve oas schemas [20/n]

www/utils/generated/oas-output/schemas/StoreCreateCart.ts

@@ -1,13 +1,13 @@
 /**
  * @schema StoreCreateCart
  * type: object
- * description: SUMMARY
+ * description: The details of the cart to be created.
  * x-schemaName: StoreCreateCart
  * properties:
  *   region_id:
  *     type: string
  *     title: region_id
- *     description: The cart's region id.
+ *     description: The ID of the cart's region. This affects the prices and currency of the cart.
  *   shipping_address:
  *     $ref: "#/components/schemas/StoreCartAddress"
  *   billing_address:
@@ -15,12 +15,13 @@
  *   email:
  *     type: string
  *     title: email
- *     description: The cart's email.
+ *     description: The email of the cart's customer.
  *     format: email
  *   currency_code:
  *     type: string
  *     title: currency_code
- *     description: The cart's currency code.
+ *     description: The cart's currency code. If not provided, the region's currency is used. This affects prices in the cart, as well.
+ *     example: usd
  *   items:
  *     type: array
  *     description: The cart's items.
@@ -29,10 +30,10 @@
  *   sales_channel_id:
  *     type: string
  *     title: sales_channel_id
- *     description: The cart's sales channel id.
+ *     description: The ID of the sales channel that cart is created in. Only products available in that sales channel can be added to the cart. If not provided, the store's default sales channel is associated with the cart instead.
  *   metadata:
  *     type: object
- *     description: The cart's metadata.
+ *     description: The cart's metadata, can hold custom key-value pairs.
  * 
 */