update

Author: devalog

fern/products/docs/pages/navigation/products.mdx

@@ -49,7 +49,7 @@ fern/
     ├─ ...
     ├─ product-a.yml # Contents and navigation for Product A
     └─ product-b.yml # Contents and navigation for Product B
-    # No yml file needed for external products
+    # No separate yml file needed for external products
 ```
 
 <CodeBlocks>
@@ -96,9 +96,9 @@ tabs:
 </Step>
 <Step title="Add your product configuration">
 
-To define a product, add an item to the `products` list in `docs.yml`, specifying the `display-name` and `path`.
+To define a product, add an item to the `products` list in `docs.yml`, specifying the `display-name` and either `path` (for internal products) or `href` (for external products).
 
-The optional parameters are: `image`, `icon`, `subtitle`, `slug`, and `versions`. If you provide both an `image` and an `icon`, the `image` will take precedence.
+For both internal and external products, `image`, `icon`, and `subtitle` are optional parameters. If you provide both an `image` and an `icon`, the `image` will take precedence. Internal products additionally support the optional `slug` and `versions` parameters. 
 
 <Note title="Product icons">
   <Markdown src="/snippets/icons.mdx" />
@@ -107,7 +107,7 @@ The optional parameters are: `image`, `icon`, `subtitle`, `slug`, and `versions`
 The below example is a `docs.yml` configuration for a site with two internal products (Product A and Product B) and one external product (Product C).
 
 <CodeBlock title="docs.yml">
-```yaml {2-3, 8-9}
+```yaml {2-3, 8-9, 14-15}
 products:
   - display-name: Product A
     path: ./products/product-a.yml
@@ -128,19 +128,21 @@ products:
 ```
 </CodeBlock>
 
-External products (like Product C above) use `href` to link to external URLs and don't require a product-specific `.yml` file in the `products` folder. Optional parameters (`image`, `icon`, `subtitle`) are supported, but versions, tabs, and navigation are not.
-
-
 </Step>
 <Step title="Remove extra navigation from docs.yml">
 
 If your `docs.yml` file includes a `navigation` field or a `tabs` field, be sure to remove. Those fields should now belong in the product-specific `.yml` files. 
+
+<Note>
+ External products don't support `navigation` and `tabs` fields.
+</Note>
+
 </Step>
 </Steps>
 
 ### Add versioning to your products
 
-You can optionally add versions to your products. Versioned and unversioned products can live next to each other in your site.
+You can optionally add versions to your internal products. Versioned and unversioned products can live next to each other in your site. Versions are not supported for external products.
 
 <Note>For standalone versioning without products, see our [Versioning guide](/docs/configuration/versions).</Note>