Merge branch 'main' into kenny/add-ai-tooling-docs

Author: fern-support

fern/docs.yml

@@ -303,10 +303,14 @@ redirects:
     destination: /learn/docs/writing-content/components/accordions
   - source: /learn/docs/writing-content/components/card-groups
     destination: /learn/docs/writing-content/components/cards
+  - source: /learn/docs/writing-content/components/embed
+    destination: /learn/docs/writing-content/components/download
   - source: /learn/docs/building-and-customizing-your-docs/navigation
     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
@@ -467,6 +471,8 @@ redirects:
     destination: /learn/ask-fern/configuration/custom-prompts
   - source: /learn/ask-fern/configuration/locations-and-datasources
     destination: /learn/ask-fern/configuration/setup
+  - source: /learn/ask-fern/configuration/custom-prompts
+    destination: /learn/ask-fern/configuration/setup
 
   # General Ask Fern patterns
   - source: /learn/ai-search/getting-started/:slug*

fern/products/ask-fern/ask-fern.yml

@@ -10,10 +10,8 @@ navigation:
   - section: Configuration
     contents:
       - page: Setup
-        path: ./pages/configuration/locations-and-datasources.mdx
+        path: ./pages/configuration/setup.mdx
         slug: setup
-      - page: Custom prompts
-        path: ./pages/configuration/custom-prompting.mdx
       - page: Guidance
         path: ./pages/features/guidance.mdx
       - page: Documents

fern/products/ask-fern/pages/configuration/custom-prompting.mdx

@@ -60,7 +60,7 @@ ai-search:
   <Card 
     title="Custom prompting"
     icon="regular book-open"
-    href="/learn/ask-fern/configuration/custom-prompts"
+    href="/learn/ask-fern/configuration/setup#ai-searchsystem-prompt"
   >
     Write custom prompts to improve accuracy and tailor responses for your users. 
   </Card>

fern/products/ask-fern/pages/configuration/locations-and-datasources.mdx renamed to fern/products/ask-fern/pages/configuration/setup.mdx

@@ -1,3 +1,26 @@
+## 0.108.0
+**`(feat):`** Add position-based sorting for folder navigation in docs.yml. Pages can now control their order using a `position` field in frontmatter. Pages with position values sort first (ascending), then pages without position sort alphabetically.
+
+Example:
+```markdown
+---
+position: 1
+---
+# Getting Started
+```
+
+
+**`(fix):`** Fix hot-reload in `fern docs dev` to detect frontmatter position changes. Previously, changing position values required restarting the dev server. Now position changes, file additions, and file deletions trigger automatic navigation rebuilds.
+
+
+## 0.107.11
+**`(fix):`** Fix AsyncAPI v3 message parsing where channel messages were not being included in generated WebSocket clients. Messages defined in AsyncAPI v3 specs are now correctly resolved and included in the SDK.
+
+
+## 0.107.10
+**`(chore):`** Update migration logic to support new generator versions with ir v61.
+
+
 ## 0.107.9
 **`(fix):`** Implement variant ranking in anyOf/oneOf example generation to prefer variants that use provided examples without coercion over variants that require coercion or generate fallback examples. When a schema has anyOf: [number, string] with examples: ["2500"], the string variant is now preferred since it can use the provided example as-is, rather than the number variant which would coerce it to a number.
 

fern/products/ask-fern/pages/getting-started/what-is-ask-fern.mdx

@@ -67,9 +67,9 @@ navigation:
             path: ./pages/component-library/default-components/code-blocks.mdx
             icon: fa-duotone fa-code
             slug: code-blocks
-          - page: Embed
-            path: ./pages/component-library/default-components/embed.mdx
-            icon: fa-duotone fa-window-restore
+          - page: Download
+            path: ./pages/component-library/default-components/download.mdx
+            icon: fa-duotone fa-download
           - page: Endpoint request snippet
             path: ./pages/component-library/default-components/endpoint-request-snippet.mdx
             icon: fa-duotone fa-arrow-up
@@ -274,6 +274,8 @@ navigation:
         slug: analytics/mixpanel
       - page: Postman
         path: ./pages/integrations/postman.mdx
+      - page: Mintlify
+        path: ./pages/integrations/mintlify.mdx
       - page: LaunchDarkly feature flags 
         path: ./pages/integrations/feature-flags.mdx
         hidden: true

fern/products/cli-api-reference/cli-changelog/2025-11-05.mdx

@@ -14,3 +14,24 @@ curl https://docs.example.com/platform/overview \
 Content is served as clean Markdown for token-efficient processing.
 
 Learn more in the [MCP server documentation](/learn/docs/ai-features/mcp-server).
+
+## 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. Fern discovers all `.md` and `.mdx` files and adds them to the navigation.
+
+```yaml docs.yml {6-10}
+navigation:
+  - section: Getting started
+    contents:
+      - page: Introduction
+        path: ./pages/intro.mdx
+      - folder: ./pages/guides
+        title: Guides # Display name for folder section
+        icon: fa-regular fa-book
+        collapsed: true
+        availability: beta # Optional badge to display in navigation
+```
+
+Subfolders become nested sections. Supported options: `title`, `slug`, `icon`, `collapsed`, `hidden`, `skip-slug`, `availability`.
+
+[Learn more about navigation configuration](/learn/docs/configuration/navigation).

fern/products/docs/docs.yml

@@ -0,0 +1,38 @@
+---
+title: "Download"
+description: "Download assets like PDFs directly from your documentation"
+---
+
+The `<Download>` component lets users download assets like PDFs directly from your documentation.
+
+<Info>
+For information on how to embed assets, check out the documentation on [Images](/learn/docs/writing-content/markdown#images), [PDFs](/learn/docs/writing-content/markdown#pdfs), and [Videos](/learn/docs/writing-content/markdown#videos).
+</Info>
+
+## Usage
+
+<div className="highlight-frame">
+<Download src="./all-about-ferns.pdf">
+  <Button intent="primary">Download PDF</Button>
+</Download>
+</div>
+
+```jsx Markdown
+<Download src="./all-about-ferns.pdf">
+  <Button intent="primary">Download PDF</Button>
+</Download>
+```
+
+## Properties
+
+<ParamField path="src" type="string" required={true}>
+  Path to your local asset (relative to current MDX file). The asset must be located within the `fern` folder.
+</ParamField>
+
+<ParamField path="children" type="React.ReactNode" required={true}>
+  The text or element to display as the click target for the download.
+</ParamField>
+
+<ParamField path="filename" type="string">
+  The filename to use for the downloaded asset. If not provided, the filename will be the same as the asset's name.
+</ParamField>