diff --git a/fern/products/sdks/reference/generators-yml-reference.mdx b/fern/products/sdks/reference/generators-yml-reference.mdx
index dea21c26e..db12b41bd 100644
--- a/fern/products/sdks/reference/generators-yml-reference.mdx
+++ b/fern/products/sdks/reference/generators-yml-reference.mdx
@@ -785,24 +785,57 @@ Specify which teams and users should review generated code. See [reviewers confi
 
 ### Generator Metadata
 
-<ParamField path="groups.{groupName}.generators[].metadata.package-description" type="string" required={false} toc={true}>
+Specify metadata for your SDK generator.
+
+```yml {6-10}
+groups: 
+  ts-sdk:
+    generators:
+      - name: fernapi/fern-typescript-sdk
+      ...
+        metadata: 
+          package-description: "Description of your SDK"
+          email: "sdk@example.com"
+          reference-url: "https://docs.example.com/sdks"
+          license: "MIT"
+```
+
+<ParamField path="package-description" type="string" required={false} toc={true}>
+A brief description of what your generated SDK does and its key features. This appears in the `package.json` description field and package registry listings.
 </ParamField>
 
-<ParamField path="groups.{groupName}.generators[].metadata.email" type="string" required={false} toc={true}>
+<ParamField path="email" type="string" required={false} toc={true}>
+Contact email for the package maintainer or support team. 
 </ParamField>
 
-<ParamField path="groups.{groupName}.generators[].metadata.reference-url" type="string" required={false} toc={true}>
+<ParamField path="reference-url" type="string" required={false} toc={true}>
+URL pointing to comprehensive documentation, API reference, or getting started guide for the SDK.
 </ParamField>
 
-<ParamField path="groups.{groupName}.generators[].metadata.author" type="string" required={false} toc={true}>
+<ParamField path="author" type="string" required={false} toc={true}>
+Name of the individual developer, team, or organization that created and maintains the SDK.
 </ParamField>
 
-<ParamField path="groups.{groupName}.generators[].metadata.license" type="GithubLicenseSchema" required={false} toc={true}>
+<ParamField path="license" type="'MIT' | 'Apache-2.0' | { custom: 'Custom License Name' }" required={false} toc={true}>
+Software license for the generated SDK.
 </ParamField>
 
 ### Snippets Configuration
 
-<ParamField path="groups.{groupName}.generators[].snippets.path" type="string" required={true} toc={true}>
+Configures snippets for a particular generator.
+
+```yml {6-8}
+groups: 
+  ts-sdk:
+    generators:
+      - name: fernapi/fern-typescript-sdk
+      ...
+        snippets: 
+          path: "./snippets"
+```
+
+<ParamField path="path" type="string" required={true} toc={true}>
+The path to the generated snippets file.
 </ParamField>
 
 ### API Settings Override