refactor: integrate folder configuration into navigation overview

- Remove standalone folder-based-navigation.mdx page
- Add concise 'Add pages from a folder' section to navigation overview
- Create reusable snippet at /fern/snippets/folder-nav-basic.mdx
- Add redirect from old URL to navigation overview
- Add changelog entry for 2025-11-05
- Keep documentation dry and concise as requested

Co-Authored-By: Deep Singhvi <[email protected]>

Author: devin-ai-integration[bot]

fern/docs.yml

@@ -312,6 +312,8 @@ redirects:
     destination: /learn/docs/configuration/navigation
   - source: /learn/docs/navigation/overview
     destination: /learn/docs/configuration/navigation
+  - source: /learn/docs/configuration/folder-based-navigation
+    destination: /learn/docs/configuration/navigation
   - source: /learn/docs/building-and-customizing-your-docs/versioning
     destination: /learn/docs/configuration/versions
   - source: /learn/docs/navigation/versions

fern/products/docs/docs.yml

@@ -19,8 +19,6 @@ navigation:
         path: ./pages/customization/what-is-docs-yml.mdx
       - page: Navigation
         path: ./pages/navigation/overview.mdx
-      - page: Folder-based navigation
-        path: ./pages/navigation/folder-based-navigation.mdx
       - page: Tabs and tab variants
         path: ./pages/navigation/tabs.mdx
         slug: tabs

fern/products/docs/pages/changelog/2025-11-05.mdx

@@ -0,0 +1,9 @@
+## Folder-based navigation
+
+Auto-generate navigation from a folder of markdown files using the new `folder` configuration. Instead of manually listing each page in `docs.yml`, point to a folder and Fern discovers all `.md` and `.mdx` files and adds them to the navigation.
+
+<Markdown src="/snippets/folder-nav-basic.mdx" />
+
+Subfolders become nested sections. Supported options: `title`, `slug`, `icon`, `collapsed`, `hidden`, `skip-slug`, `availability`.
+
+[Learn more about navigation configuration](/learn/docs/configuration/navigation#add-pages-from-a-folder).

fern/products/docs/pages/navigation/folder-based-navigation.mdx

@@ -80,6 +80,14 @@ navigation:
 ```
 {/* <!-- vale on --> */}
 
+### Add pages from a folder
+
+Use `folder` to auto-generate pages from a directory. Fern discovers all `.md` and `.mdx` files in the specified folder and adds them to the navigation.
+
+<Markdown src="/snippets/folder-nav-basic.mdx" />
+
+Subfolders become nested sections. Supported options: `title`, `slug`, `icon`, `collapsed`, `hidden`, `skip-slug`, `availability`.
+
 ### Hiding content
 
 To hide a page or an entire section of your docs, add `hidden: true`. A hidden page or section will still be discoverable using the exact URL, but it will be excluded from search and won't be indexed.

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

@@ -0,0 +1,9 @@
+```yaml docs.yml
+navigation:
+  - section: Getting started
+    contents:
+      - page: Introduction
+        path: ./pages/intro.mdx
+      - folder: ./pages/guides
+        title: Guides
+```