oas: [2/n] improve schema oas (#9040)

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

@@ -1,7 +1,7 @@
 /**
  * @schema AdminCreateRegion
  * type: object
- * description: SUMMARY
+ * description: The region's details.
  * x-schemaName: AdminCreateRegion
  * required:
  *   - name
@@ -15,31 +15,34 @@
  *     type: string
  *     title: currency_code
  *     description: The region's currency code.
+ *     example: usd
  *   countries:
  *     type: array
  *     description: The region's countries.
  *     items:
  *       type: string
  *       title: countries
- *       description: The country's countries.
+ *       description: A country code.
+ *       example: us
  *   automatic_taxes:
  *     type: boolean
  *     title: automatic_taxes
- *     description: The region's automatic taxes.
+ *     description: Whether taxes are calculated automatically during checkout in this region.
  *   is_tax_inclusive:
  *     type: boolean
  *     title: is_tax_inclusive
- *     description: The region's is tax inclusive.
+ *     description: Whether prices in this region are tax inclusive.
  *   payment_providers:
  *     type: array
- *     description: The region's payment providers.
+ *     description: The payment providers enabled in this region.
  *     items:
  *       type: string
  *       title: payment_providers
- *       description: The payment provider's payment providers.
+ *       description: A payment provider's ID.
+ *       example: pp_stripe_stripe
  *   metadata:
  *     type: object
- *     description: The region's metadata.
+ *     description: The region's metadata, used to store custom key-value pairs.
  * 
 */