diff --git a/fern/products/sdks/overview/python/configuration.mdx b/fern/products/sdks/overview/python/configuration.mdx
index 2556a076c..6c4cece39 100644
--- a/fern/products/sdks/overview/python/configuration.mdx
+++ b/fern/products/sdks/overview/python/configuration.mdx
@@ -23,6 +23,7 @@ groups:
 ## SDK Configuration Options
 
 <ParamField path="additional_init_exports" type="array" default="null" required={false} toc={true}>
+Additional modules or classes to export from the package's `__init__.py` file. This allows you to customize what's available when users import your package.
 </ParamField>
 
 <ParamField path="default_bytes_stream_chunk_size" type="number" default="null" required={false} toc={true}>
@@ -30,6 +31,7 @@ groups:
 </ParamField>
 
 <ParamField path="exclude_types_from_init_exports" type="bool" default="false" required={false} toc={true}>
+When enabled, excludes type definitions from being exported in the package's `__init__.py` file, reducing the public API surface.
 </ParamField>
 
 <ParamField path="extra_dependencies" type="object" default="{}" required={false} toc={true}>
@@ -42,12 +44,15 @@ groups:
 </ParamField>
 
 <ParamField path="extra_dev_dependencies" type="object" default="{}" required={false} toc={true}>
+Specify additional development dependencies to include in the generated SDK's setup configuration. These are dependencies used for development and testing but not required by end users.
 </ParamField>
 
 <ParamField path="extras" type="object" default="{}" required={false} toc={true}>
+Define optional dependency groups that users can install with your package using pip extras (e.g., `pip install your-package[extra-name]`).
 </ParamField>
 
 <ParamField path="flat_layout" type="bool" default="false" required={false} toc={true}>
+When enabled, generates a flatter package structure by reducing nested directories and modules.
 </ParamField>
 
 <ParamField path="follow_redirects_by_default" type="bool" default="true" required={false} toc={true}>
@@ -63,6 +68,7 @@ groups:
 </ParamField>
 
 <ParamField path="include_union_utils" type="bool" default="false" required={false} toc={true}>
+When enabled, generates utility methods for working with union types, including factory methods and visitor patterns.
 </ParamField>
 
 <ParamField path="inline_path_params" type="bool" default="false" required={false} toc={true}>
@@ -98,6 +104,7 @@ groups:
 </ParamField>
 
 <ParamField path="pyproject_toml" type="string" default="null" required={false} toc={true}>
+Path to a custom `pyproject.toml` template file to use instead of the default generated one.
 </ParamField>
 
 <ParamField path="should_generate_websocket_clients" type="bool" default="false" required={false} toc={true}>
@@ -105,6 +112,7 @@ groups:
 </ParamField>
 
 <ParamField path="skip_formatting" type="bool" default="false" required={false} toc={true}>
+When enabled, skips code formatting (like black) on the generated Python code.
 </ParamField>
 
 <ParamField path="timeout_in_seconds" type="number | 'infinity'" default="60" required={false} toc={true}>
@@ -112,6 +120,7 @@ groups:
 </ParamField>
 
 <ParamField path="use_api_name_in_package" type="bool" default="false" required={false} toc={true}>
+When enabled, includes the API name as part of the package structure and naming.
 </ParamField>
 
 <ParamField path="use_inheritance_for_extended_models" type="bool" default="true" required={false} toc={true}>
diff --git a/fern/products/sdks/overview/ruby/configuration.mdx b/fern/products/sdks/overview/ruby/configuration.mdx
index 9c9475f6d..ec531c5a9 100644
--- a/fern/products/sdks/overview/ruby/configuration.mdx
+++ b/fern/products/sdks/overview/ruby/configuration.mdx
@@ -19,19 +19,20 @@ groups:
 ## SDK Configuration Options
 
 <ParamField path="clientClassName" type="string" required={false} toc={true}>
+The name of the generated client class. This allows you to customize the class name that users will instantiate when using your SDK.
 </ParamField>
-
 <ParamField path="defaultTimeoutInSeconds" type="number | 'infinity'" required={false} toc={true}>
+The default timeout for network requests in seconds. In the generated client, this can be overridden at the request level. Set to 'infinity' to disable timeouts.
 </ParamField>
-
 <ParamField path="extraDependencies" type="ExtraDependenciesSchema" required={false} toc={true}>
+Specify additional dependencies to include in the generated SDK's gemspec. This is useful when you need to add custom gems that your SDK depends on.
 </ParamField>
-
 <ParamField path="extraDevDependencies" type="ExtraDependenciesSchema" required={false} toc={true}>
+Specify additional development dependencies to include in the generated SDK's gemspec. These are dependencies used for development and testing but not required by end users.
 </ParamField>
-
 <ParamField path="flattenModuleStructure" type="boolean" default="false" required={false} toc={true}>
+When enabled, flattens the module structure of the generated SDK. This creates a simpler namespace hierarchy by reducing nested modules.
 </ParamField>
-
 <ParamField path="useProvidedDefaults" type="boolean" required={false} toc={true}>
+When enabled, the SDK will use default values specified in your API definition. This allows you to leverage defaults defined in your Fern specification within the generated Ruby client.
 </ParamField>
\ No newline at end of file