docs: generate OAS with events (#12394)

* docs: generate OAS with events * small change
2025-05-07 14:57:03 +03:00
parent 262064fe96
commit a3bdb3e383
515 changed files with 3808 additions and 189 deletions
--- a/www/apps/api-reference/specs/admin/components/schemas/BaseOrderAddress.yaml
+++ b/www/apps/api-reference/specs/admin/components/schemas/BaseOrderAddress.yaml
@@ -51,7 +51,11 @@ properties:
  province:
    type: string
    title: province
-    description: The address's province.
+    description: The address's lower-case ISO 3166-2 province code.
+    example: US-CA
+    externalDocs:
+      url: https://en.wikipedia.org/wiki/ISO_3166-2
+      description: Learn more about ISO 3166-2
  postal_code:
    type: string
    title: postal_code