chore(docs): Generated API Reference (#4706)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>

docs/api/admin/components/schemas/ProductCollection.yaml

@@ -1,5 +1,8 @@
 title: Product Collection
-description: Product Collections represents a group of Products that are related.
+description: >-
+  A Product Collection allows grouping together products for promotional
+  purposes. For example, an admin can create a Summer collection, add products
+  to it, and showcase it on the storefront.
 type: object
 required:
   - created_at
@@ -26,10 +29,9 @@ properties:
     type: string
     example: summer-collection
   products:
-    description: >-
-      The Products contained in the Product Collection. Available if the
-      relation `products` is expanded.
+    description: The details of the products that belong to this product collection.
     type: array
+    x-expandable: products
     items:
       type: object
   created_at:
@@ -51,3 +53,7 @@ properties:
     type: object
     example:
       car: white
+    externalDocs:
+      description: Learn about the metadata attribute, and how to delete and update it.
+      url: >-
+        https://docs.medusajs.com/development/entities/overview#metadata-attribute