From 4f6f85dad42ae4bf5ccc8ab19eac08bf394f527a Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Sat, 1 Nov 2025 16:07:04 +0000
Subject: [PATCH 1/3] docs: document navbar dropdown link type

Co-Authored-By: Catherine Deskur <catherine@buildwithfern.com>
---
 .../pages/customization/what-is-docs-yml.mdx  | 24 ++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/fern/products/docs/pages/customization/what-is-docs-yml.mdx b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
index 72caf14d5..511988e9b 100644
--- a/fern/products/docs/pages/customization/what-is-docs-yml.mdx
+++ b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
@@ -242,10 +242,23 @@ navbar-links:
     rounded: false
   - type: github
     value: https://github.com/example-company/fern
+  - type: dropdown
+    text: Resources
+    icon: fa-solid fa-book
+    links:
+      - text: Documentation
+        href: https://example.com/docs
+        icon: fa-regular fa-file-lines
+      - text: API Reference
+        href: https://example.com/api
+        icon: fa-regular fa-code
+      - text: Tutorials
+        href: https://example.com/tutorials
+        icon: fa-regular fa-graduation-cap
 ```
 
 <ParamField path="type" type="enum" required={false} toc={true}>
-  One of `outlined`, `minimal`, `filled`, or `github`. This value controls the styling of the button. 
+  One of `outlined`, `minimal`, `filled`, `github`, or `dropdown`. This value controls the styling of the button. 
 </ParamField>
 
 <ParamField path="href" type="string" required={false} toc={true}>
@@ -274,6 +287,15 @@ navbar-links:
   By default, the `rightIcon` for a `filled` button is set to `arrow-right`.
 </ParamField>
 
+<ParamField path="links" type="list of objects" required={false} toc={true}>
+  Array of link objects to display in the dropdown menu. This field is used when `type` is set to `dropdown`. Each link object can have the following properties:
+  - `text` (string): The text to display for the link
+  - `href` (string): The URL the link points to
+  - `icon` (string): Optional [Font Awesome icon](https://fontawesome.com/icons) to display to the left of the text
+  - `rightIcon` (string): Optional [Font Awesome icon](https://fontawesome.com/icons) to display to the right of the text
+  - `rounded` (boolean): When `true`, the link will have fully rounded borders
+</ParamField>
+
 ## Footer links configuration
 
 Add clickable social media and community links to your documentation site footer to improve discoverability and engagement.

From 070cb25bd81f4e9a26e5d46a35533b1fa6d77da9 Mon Sep 17 00:00:00 2001
From: Devin Logan <devinannlogan@gmail.com>
Date: Sun, 2 Nov 2025 08:02:37 -0500
Subject: [PATCH 2/3] break out options into separate params

---
 .../pages/customization/what-is-docs-yml.mdx  | 27 ++++++++++++++-----
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/fern/products/docs/pages/customization/what-is-docs-yml.mdx b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
index 511988e9b..42126b750 100644
--- a/fern/products/docs/pages/customization/what-is-docs-yml.mdx
+++ b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
@@ -288,12 +288,27 @@ navbar-links:
 </ParamField>
 
 <ParamField path="links" type="list of objects" required={false} toc={true}>
-  Array of link objects to display in the dropdown menu. This field is used when `type` is set to `dropdown`. Each link object can have the following properties:
-  - `text` (string): The text to display for the link
-  - `href` (string): The URL the link points to
-  - `icon` (string): Optional [Font Awesome icon](https://fontawesome.com/icons) to display to the left of the text
-  - `rightIcon` (string): Optional [Font Awesome icon](https://fontawesome.com/icons) to display to the right of the text
-  - `rounded` (boolean): When `true`, the link will have fully rounded borders
+  Items to display in the dropdown menu when `type` is set to `dropdown`.
+</ParamField>
+
+<ParamField path="links.text" type="string" required={false} toc={true}>
+  The text to display for the link.
+</ParamField>
+
+<ParamField path="links.href" type="string" required={false} toc={true}>
+  The URL the link points to.
+</ParamField>
+
+<ParamField path="links.icon" type="string" required={false} toc={true}>
+  [Font Awesome icon](https://fontawesome.com/icons) that displays to the left of the text.
+</ParamField>
+
+<ParamField path="links.rightIcon" type="string" required={false} toc={true}>
+  [Font Awesome icon](https://fontawesome.com/icons) that displays to the right of the text
+</ParamField>
+
+<ParamField path="links.rounded" type="boolean" required={false} default={false} toc={true}>
+  When `true`, the link will have fully rounded borders.
 </ParamField>
 
 ## Footer links configuration

From 3509bff971537a766e95b0614e8f3a2fa13b5b6b Mon Sep 17 00:00:00 2001
From: Devin Logan <devinannlogan@gmail.com>
Date: Sun, 2 Nov 2025 08:05:43 -0500
Subject: [PATCH 3/3] formatting nit

---
 fern/products/docs/pages/customization/what-is-docs-yml.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fern/products/docs/pages/customization/what-is-docs-yml.mdx b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
index 42126b750..8e5a1d02b 100644
--- a/fern/products/docs/pages/customization/what-is-docs-yml.mdx
+++ b/fern/products/docs/pages/customization/what-is-docs-yml.mdx
@@ -307,7 +307,7 @@ navbar-links:
   [Font Awesome icon](https://fontawesome.com/icons) that displays to the right of the text
 </ParamField>
 
-<ParamField path="links.rounded" type="boolean" required={false} default={false} toc={true}>
+<ParamField path="links.rounded" type="boolean" required={false} default="false" toc={true}>
   When `true`, the link will have fully rounded borders.
 </ParamField>