Sync open source content 🐝 (from 70736dba5645ea638e23169e22e2cd48a40c312c)

Author: beezythebot

docs/terraform/entity-mapping.mdx

@@ -315,15 +315,22 @@ Terraform resources require an object-type root schema. When an API returns an a
 **Default behavior:**
 
 ```yaml
-data:
-  type: array
-  items:
-    x-speakeasy-entity: Things
+paths:
+  /things:
+    get:
+      x-speakeasy-entity-operation: Things#read
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  x-speakeasy-entity: Things
 ```
 
-In this example, `data` appears twice but means different things:
-- `data:` is your OpenAPI property name
-- The wrapping attribute is also named `data` by default (unrelated to the property name)
+Since the response is `type: array`, Speakeasy wraps it in a `data` attribute for Terraform compatibility.
 
 Access in Terraform:
 
@@ -334,11 +341,20 @@ data.my_things_list.data[0].id
 **Customize the wrapper name:**
 
 ```yaml
-data:
-  x-speakeasy-wrapped-attribute: items
-  type: array
-  items:
-    x-speakeasy-entity: Things
+paths:
+  /things:
+    get:
+      x-speakeasy-entity-operation: Things#read
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                x-speakeasy-wrapped-attribute: items
+                type: array
+                items:
+                  x-speakeasy-entity: Things
 ```
 
 Now the wrapping attribute is named `items` instead:
@@ -348,7 +364,7 @@ data.my_things_list.items[0].id
 ```
 
 <Callout title="Note" type="info">
-  The wrapping attribute name is a Terraform construct created by Speakeasy, completely separate from your OpenAPI property names. Use `x-speakeasy-wrapped-attribute` to customize it.
+  The wrapping attribute name is a Terraform construct created by Speakeasy, completely separate from your API's response structure. Use `x-speakeasy-wrapped-attribute` to customize it.
 </Callout>
 
 ### Resources with Soft Delete