Sync open source content 🐝 (from cde2f02cd995796df17eee133998cb35a652419f)

Author: beezythebot

docs/sdks/customize/data-model/enums.mdx

@@ -140,8 +140,8 @@ class EnumField(str, Enum):
 ## Open vs closed enums
 
 <Callout title="Note" type="info">
-  This feature is currently supported in Go, Python, TypeScript, Java, C#, and
-  Ruby SDKs.
+  This feature is currently supported in Go, Python, TypeScript, Java, C#,
+  Ruby, and Terraform.
 </Callout>
 
 By default, enums defined in OpenAPI are considered closed during code

docs/sdks/manage/forward-compatibility.mdx

@@ -255,6 +255,14 @@ Generator options enable additional forward compatibility features. These are co
       laxCoercion: "Contact us",
       smartUnions: "✅",
     },
+    {
+      language: "Terraform",
+      enums: "✅",
+      unions: "Contact us",
+      requiredFields: "Contact us",
+      laxCoercion: "Contact us",
+      smartUnions: "Contact us",
+    },
     {
       language: "PHP",
       enums: "Contact us",
@@ -317,12 +325,18 @@ Generator options enable additional forward compatibility features. These are co
   forwardCompatibleEnumsByDefault: true
   unionStrategy: populated-fields`,
     },
+    {
+      label: "Terraform",
+      language: "yaml",
+      code: `terraform:
+  forwardCompatibleEnumsByDefault: true`,
+    },
   ]}
 />
 
 ### Forward-compatible enums
 
-When `forwardCompatibleEnumsByDefault` is enabled (the default), enums accept unknown values instead of rejecting the response:
+When `forwardCompatibleEnumsByDefault` is enabled (the default, except for Terraform), enums accept unknown values instead of rejecting the response:
 
 ```typescript
 const notification = await sdk.notifications.get(id);
@@ -372,7 +386,7 @@ When `unionStrategy` is set to `populated-fields` (the default for new TypeScrip
 This prevents issues where one union variant is a subset of another and the wrong variant gets selected due to ordering.
 
 <Callout type="info" title="Per-schema overrides">
-Individual enums and unions can override global defaults using `x-speakeasy-unknown-values: allow` or `x-speakeasy-unknown-values: disallow` in the OpenAPI spec. See the [TypeScript configuration reference](/docs/speakeasy-reference/generation/ts-config#forward-compatibility) or [Ruby configuration reference](/docs/speakeasy-reference/generation/ruby-config#forward-compatibility) for all available options.
+Individual enums and unions can override global defaults using `x-speakeasy-unknown-values: allow` or `x-speakeasy-unknown-values: disallow` in the OpenAPI spec. See the [TypeScript configuration reference](/docs/speakeasy-reference/generation/ts-config#forward-compatibility), [Ruby configuration reference](/docs/speakeasy-reference/generation/ruby-config#forward-compatibility), or [Terraform configuration reference](/docs/speakeasy-reference/generation/terraform-config#forward-compatibility) for all available options.
 </Callout>
 
 ## Evolving APIs safely

docs/speakeasy-reference/extensions.mdx

@@ -82,7 +82,8 @@ x-speakeasy-extension-rewrite:
     { extension: "x-speakeasy-wrapped-attribute", description: "Enables additional API operation data to be placed under a specifically named attribute." },
     { extension: "x-speakeasy-xor-with", description: "Indicate mutually exclusive properties to prevent incompatible combinations in Terraform configurations." },
     { extension: "x-speakeasy-match", description: "Adjusts an API parameter name to align with a Terraform state property." },
-    { extension: "x-speakeasy-response-filter", description: "Enable client-side filtering of list API responses in data resources by marking response properties that Terraform users can filter on." }
+    { extension: "x-speakeasy-response-filter", description: "Enable client-side filtering of list API responses in data resources by marking response properties that Terraform users can filter on." },
+    { extension: "x-speakeasy-unknown-values", description: "Control whether an enum is open or closed in the generated Terraform provider. Set to `allow` to accept unknown enum values or `disallow` to reject them. Can also be enabled globally via the `forwardCompatibleEnumsByDefault` config option." }
   ]}
   columns={[
     { key: "extension", header: "Terraform extension" },

docs/speakeasy-reference/generation/terraform-config.mdx

@@ -91,6 +91,31 @@ terraform:
   ]}
 />
 
+## Forward compatibility
+
+```yml
+terraform:
+  forwardCompatibleEnumsByDefault: true
+```
+
+<Table
+  data={[
+    {
+      name: "forwardCompatibleEnumsByDefault",
+      required: "false",
+      default: "false",
+      description:
+        "When true, enums used in responses are generated as open enums that accept unknown values. This prevents new enum values added by the API from breaking the Terraform provider. Individual enums can be controlled with `x-speakeasy-unknown-values: allow` or `x-speakeasy-unknown-values: disallow` in the OpenAPI spec.",
+    },
+  ]}
+  columns={[
+    { key: "name", header: "Name" },
+    { key: "required", header: "Required" },
+    { key: "default", header: "Default Value" },
+    { key: "description", header: "Description" },
+  ]}
+/>
+
 ## Environment variables
 
 ```yml