chore(docs): Add example to fern generator upgrade command in CLI r…

…eference (#5932)

* chore(docs): Document fern generator upgrade command

* document fern generator upgrade command

* add back detail

* revise filesentencecasing

* hide on this page

fern/docs.yml

@@ -453,7 +453,7 @@ navigation:
                 icon: fa-regular fa-icons
                 slug: icons
               - page: Parameter Fields
-                path: ./pages/docs/components/ParamField.mdx
+                path: ./pages/docs/components/paramfield.mdx
                 icon: fa-regular fa-input-text
                 slug: paramfield
               - page: Steps

fern/pages/cli-api/commands.mdx

@@ -2,6 +2,7 @@
 title: 'Commands'
 description: 'Complete reference for all Fern CLI commands for generating SDKs and developer documentation.'
 subtitle: 'Learn about the Fern CLI commands.'
+hideOnThisPage: true
 ---
 
 | Command | Description |
@@ -460,9 +461,28 @@ subtitle: 'Learn about the Fern CLI commands.'
     - Update the generator versions to their latest compatible releases
     - Maintain compatibility with your current Fern compiler version
 
+    Here's what you might see when updates are available:
+
+    ```plaintext
+    ┌───────────────────────────────────────────────────────────────────────────────────┐
+    │                                                                                   │
+    │                                Upgrades available                                 │
+    │                                                                                   │
+    │                                                                                   │
+    │             C# SDK (API: openapi, Group: csharp-sdk) 1.9.11 → 1.9.15              │
+    │              Java SDK (API: openapi, Group: java-sdk) 2.2.0 → 2.11.3              │
+    │           Python SDK (API: openapi, Group: python-sdk) 4.3.10 → 4.3.11            │
+    │                                                                                   │
+    │              Run fern generator upgrade to upgrade your generators.               │
+    │   Run fern generator upgrade --list to see the full list of generator upgrades    │
+    │                                    available.                                     │
+    │                                                                                   │
+    └───────────────────────────────────────────────────────────────────────────────────┘
+    ```
+
     ### list
 
-    Use `--list` to see all available generator upgrades without applying them.
+    Use `--list` to see the full list of generator upgrades available.
 
     ```bash
     fern generator upgrade --list
@@ -489,4 +509,4 @@ subtitle: 'Learn about the Fern CLI commands.'
     This is different from `fern upgrade` which updates the Fern CLI version. Use both commands to keep your entire Fern toolchain up to date.
     </Note>
   </Accordion>
-</AccordionGroup>
+</AccordionGroup>