chore(oas): [16/n] improve oas schemas (#9272)

- Improve OAS schemas [16/n]
- fixes and improvements to docs-generator tool

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

@@ -1,7 +1,7 @@
 /**
  * @schema BaseOrderAddress
  * type: object
- * description: The exchange's billing address.
+ * description: An order address
  * x-schemaName: BaseOrderAddress
  * required:
  *   - id
@@ -12,64 +12,67 @@
  *   id:
  *     type: string
  *     title: id
- *     description: The billing address's ID.
+ *     description: The address's ID.
  *   customer_id:
  *     type: string
  *     title: customer_id
- *     description: The billing address's customer id.
+ *     description: The ID of the customer this address belongs to.
  *   first_name:
  *     type: string
  *     title: first_name
- *     description: The billing address's first name.
+ *     description: The address's first name.
  *   last_name:
  *     type: string
  *     title: last_name
- *     description: The billing address's last name.
+ *     description: The address's last name.
  *   phone:
  *     type: string
  *     title: phone
- *     description: The billing address's phone.
+ *     description: The address's phone.
  *   company:
  *     type: string
  *     title: company
- *     description: The billing address's company.
+ *     description: The address's company.
  *   address_1:
  *     type: string
  *     title: address_1
- *     description: The billing address's address 1.
+ *     description: The address's first line.
  *   address_2:
  *     type: string
  *     title: address_2
- *     description: The billing address's address 2.
+ *     description: The address's second line.
  *   city:
  *     type: string
  *     title: city
- *     description: The billing address's city.
+ *     description: The address's city.
  *   country_code:
  *     type: string
  *     title: country_code
- *     description: The billing address's country code.
+ *     description: The address's country code.
+ *     example: us
+ *   country:
+ *     $ref: "#/components/schemas/AdminRegionCountry"
  *   province:
  *     type: string
  *     title: province
- *     description: The billing address's province.
+ *     description: The address's province.
  *   postal_code:
  *     type: string
  *     title: postal_code
- *     description: The billing address's postal code.
+ *     description: The address's postal code.
  *   metadata:
  *     type: object
- *     description: The billing address's metadata.
+ *     description: The address's metadata, can hold custom key-value pairs.
  *   created_at:
  *     type: string
  *     format: date-time
  *     title: created_at
- *     description: The billing address's created at.
+ *     description: The date the address was created.
  *   updated_at:
  *     type: string
  *     format: date-time
  *     title: updated_at
- *     description: The billing address's updated at.
+ *     description: The date the address was updated.
  * 
 */