chore(oas): [14/n] improve OAS schemas (#9202)

* chore(oas): [14/n] improve OAS schemas

* fix description of required_quantity

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

@@ -1,7 +1,7 @@
 /**
  * @schema AdminUpdateStore
  * type: object
- * description: SUMMARY
+ * description: The properties to update in a store.
  * x-schemaName: AdminUpdateStore
  * properties:
  *   name:
@@ -13,37 +13,38 @@
  *     description: The store's supported currencies.
  *     items:
  *       type: object
- *       description: The supported currency's supported currencies.
+ *       description: A store currency.
  *       required:
  *         - currency_code
  *       properties:
  *         currency_code:
  *           type: string
  *           title: currency_code
- *           description: The supported currency's currency code.
+ *           description: The currency's code.
+ *           example: usd
  *         is_default:
  *           type: boolean
  *           title: is_default
- *           description: The supported currency's is default.
+ *           description: Whether the currency is the default in the store.
  *         is_tax_inclusive:
  *           type: boolean
  *           title: is_tax_inclusive
- *           description: The supported currency's is tax inclusive.
+ *           description: Whether prices using this currency are tax inclusive.
  *   default_sales_channel_id:
  *     type: string
  *     title: default_sales_channel_id
- *     description: The store's default sales channel id.
+ *     description: The ID of the default sales channel in the store.
  *   default_region_id:
  *     type: string
  *     title: default_region_id
- *     description: The store's default region id.
+ *     description: The ID of the default region in the store.
  *   default_location_id:
  *     type: string
  *     title: default_location_id
- *     description: The store's default location id.
+ *     description: The ID of the default stock location in the store.
  *   metadata:
  *     type: object
- *     description: The store's metadata.
+ *     description: The store's metadata, can hold custom key-value pairs.
  * 
 */