make clarifying edits

Author: devalog

fern/products/sdks/snippets/readme-options.mdx

@@ -11,26 +11,18 @@ readme:
     path: "/users"
     stream: false
   customSections:
-    - title: "Usage"
-      language: "JAVA"
+    - title: "Custom Section"
+      language: "java"
       content: |
-        Add the following dependency to your project:
-        
-        ```xml
-        <dependency>
-          <groupId>{{ group }}</groupId>
-          <artifactId>{{ artifact }}</artifactId>
-          <version>{{ version }}</version>
-        </dependency>
-        ```
-    - title: "Getting Started"
-      language: "PYTHON"
+        This is a custom section. Latest package info is {{ group }}:{{ artifact }}:{{ version }}.
+    - title: "Custom Section"
+      language: "typescript"
       content: |
-        Install the SDK using pip:
-        
-        ```bash
-        pip install {{ package }}=={{ version }}
-        ```
+        Custom section for {{ packageName }}
+    - title: "Another Custom Section"
+      language: "typescript"
+      content: |
+        A second custom section for {{ packageName }}
   features:
     authentication:
       - method: "POST"
@@ -67,29 +59,6 @@ readme:
   Specifies which endpoint's code snippet to showcase as the primary example in the README.
 </ParamField>
 
-<ParamField path="customSections" type="array" required={false} toc={true}>
-  Each item in the array defines a custom section with specific language, title, and content. 
-  The sections are added to the generated README file for the specified language.
-
-  <ParamField path="title" type="string" required={true}>
-    The title of the custom section.
-  </ParamField>
-  <ParamField path="language" type="'JAVA' | 'PYTHON' | 'TYPESCRIPT' | 'NODE' | 'C_SHARP' | 'GO' | 'PHP' | 'RUBY'" required={true}>
-    The language for which this section should be added. Use the values:
-    - 'JAVA'
-    - 'PYTHON'
-    - 'TYPESCRIPT'
-    - 'NODE'
-    - 'C_SHARP'
-    - 'GO'
-    - 'PHP'
-    - 'RUBY'
-  </ParamField>
-  <ParamField path="content" type="string" required={true}>
-    The Markdown content of the custom section. You can use template variables like `{{ group }}`, `{{ artifact }}`, and `{{ version }}` within the Markdown content.
-  </ParamField>
-</ParamField>
-
 <ParamField path="features" type="map<string, list<ReadmeEndpointSchema>>" required={false} toc={true}>
   Organizes endpoints into named feature sections within the README. Each feature creates a dedicated section with example code snippets for the specified endpoints.
 </ParamField>
@@ -108,4 +77,27 @@ Specifies which endpoint's code snippet to showcase as the primary example in th
 
 <ParamField path="defaultEndpoint.stream" type="boolean" required={false} default="false" toc={true}>
   Whether the endpoint is a streaming endpoint. Defaults to `false`.
+</ParamField>
+
+### Custom sections
+
+Define a custom section in the generated README for a specific SDK. 
+
+<ParamField path="customSections.title" type="string" required={true}>
+  The title of the custom section as it will appear in the README.
+</ParamField>
+<ParamField path="customSections.language" type="'java' | 'typescript'" required={true}>
+  The target SDK language for this section. The custom section will only appear in README files generated for the specified language.
+</ParamField>
+<ParamField path="customSections.content" type="string" required={true}>
+  The Markdown content of the custom section. You can use template variables to dynamically insert package names and SDK version numbers.
+
+  | Language | Variable | Description |
+  |----------|----------|-------------|
+  | Java | `{{ group }}` | Maven groupId from `coordinate` field |
+  | Java | `{{ artifact }}` | Maven artifactId from `coordinate` field |
+  | Java | `{{ version }}` | SDK version |
+  | TypeScript | `{{ packageName }}` | Name of your package, as specified in the `package-name` field |
+  | TypeScript | `{{ version }}` | SDK version |
+
 </ParamField>