Merge remote-tracking branch 'origin/main' into 07-21-redirects-1

Author: Kapil Gowru

fern/products/docs/pages/api-references/sdk-snippets.mdx

@@ -11,16 +11,20 @@ If you use Fern's SDK Generator, you can automatically show SDK code snippets in
 
 ## Configuring SDK Snippets
 
-To configure SDK snippets, you'll need to name your SDKs in `generators.yml` and then reference that name in `docs.yml`. In the following example, We'll use `your-organization` as the package name because it is a common practice. For example, Stripe calls their npm package `stripe` and Twilio calls their PyPI package `twilio`.
+To configure SDK snippets, you'll need to name your SDKs in `generators.yml` and then reference that name in `docs.yml`. In the following example, we'll use `your-organization` as the package name because it is a common practice. For example, Stripe calls their npm package `stripe` and Twilio calls their PyPI package `twilio`.
 
 ### Add examples to your API definition
 
 In order to generate code snippets, Fern needs to read request examples from your API definition. If you're using a Fern Definition, you can follow [these instructions](/learn/api-definition/fern/examples). If you're using an OpenAPI Specification, you can follow [these instructions](https://swagger.io/docs/specification/adding-examples/).
 
 ### Define a package name for your SDK(s)
 
+Configure package names in your `generators.yml` file:
+*  For **Python/TypeScript/Ruby**, add `package-name: your-package-name` to the `output` section.
+*  For **Go**, add `repository: your-organization/your-repository` to the `github` section.
+
 <CodeBlock title="generators.yml">
-```yaml
+```yaml {9, 16, 22, 26}
 groups:
   production:
     generators:
@@ -57,15 +61,18 @@ groups:
 </Callout>
 
 ### Add the package name to your docs configuration
-Add the package name for the corresponding SDK to your `docs.yml` file. For Go, use the exact URL where the SDK repository is located. 
+Add the package name for the corresponding SDK to your `docs.yml` file:
+  *  **For Python, TypeScript, and Ruby**, `your-package-name` must match the `your-package-name` that you configured in your `generators.yml` file.
+  *  **For Go**, use the exact URL where the SDK repository is located, including the `https://github.com/`. 
 
 <CodeBlock title="docs.yml">
-```yaml 
+```yaml {4-7}
 navigation:
   - api: API Reference
     snippets:
       python: your-package-name  # <--- needs to match the naming in generators.yml
-      typescript: your-package-name
+      typescript: your-package-name # <--- needs to match the naming in generators.yml
+      ruby: your-package-name # <--- needs to match the naming in generators.yml
       go: https://github.com/your-organization/your-repository # <--- needs the https://github.com/ prefix
 ```
 </CodeBlock>

fern/products/sdks/guides/setup-local-sdk-previews.mdx

@@ -1,29 +1,42 @@
 ---
-title: Setup local SDK previews
-subtitle: Use Fern's CLI tool to preview your SDK locally.
+title: Set up local SDK previews
+description: Use Fern's CLI tool to preview your SDK locally.
 ---
 
-[Once you configure your SDK](/learn/sdks/getting-started/generate-your-first-sdk), you can preview the generated SDK code using Fern's CLI.
+Once you configure your SDK, you can use the `--preview` flag to test generated
+SDK code locally before publishing. This allows quick iteration on your Fern definition
+as you develop:
 
-Simply append the `--preview` flag to the command used to generate the SDK and you will see the generated code populated in a `.preview` folder within your `fern` folder.
+```bash
+# Preview all SDKs
+fern generate --preview
 
-<Tip title="Custom Code">
-  [If you have added custom code to your SDK](/learn/sdks/capabilities/augment-with-custom-code), `--preview` will
-  preserve those changes.
+# Preview SDK for a specific language
+fern generate --group <language>-sdk --preview
+
+```
+
+`--preview` generates your SDK code into a local `.preview/` folder within your
+`fern` folder. No changes are published to package managers or GitHub. 
+
+<Tip>
+  `--preview` preserves any custom code you added to your SDK.
 </Tip>
 
-Here's an example of how you can preview your SDK:
+## Example usage
+
+Here's an example of how you can preview a Python SDK. 
 
 <Steps>
 ### Generator configuration
-```yaml generators.yml
+```yaml title="generators.yml" {4}
 api: 
   path: ./path/to/openapi.yml
 groups:
   python-sdk:
     generators:
       - name: fernapi/fern-python-sdk
-        version: 3.0.0
+        version: <Markdown src="/snippets/version-number.mdx"/>
         output:
           location: pypi
           package-name: imdb