From bc12b6de889484fb386576419dedfe71a27e5007 Mon Sep 17 00:00:00 2001 From: "rishabh.dhadda" Date: Mon, 24 Aug 2026 18:58:11 +0000 Subject: [PATCH 01/12] docs: add Fern AI overview Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/overview.mdx | 2 +- .../docs/pages/changelog/2026-08-24.mdx | 7 ++ fern/products/home/home.yml | 4 +- fern/products/home/pages/ai.mdx | 91 +++++++++++++++++++ fern/products/home/pages/welcome.mdx | 5 + 5 files changed, 107 insertions(+), 2 deletions(-) create mode 100644 fern/products/docs/pages/changelog/2026-08-24.mdx create mode 100644 fern/products/home/pages/ai.mdx diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index 94232015e3..cfa893b337 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -4,7 +4,7 @@ description: Fern AI features help users find answers instantly, automate conten --- -Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. +Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. For the full picture across every Fern product, including the models behind each feature and the data they process, see [how Fern uses AI](/learn/home/ai). diff --git a/fern/products/docs/pages/changelog/2026-08-24.mdx b/fern/products/docs/pages/changelog/2026-08-24.mdx new file mode 100644 index 0000000000..94ff893e0b --- /dev/null +++ b/fern/products/docs/pages/changelog/2026-08-24.mdx @@ -0,0 +1,7 @@ +## How Fern uses AI + +ai + +You can now review how Fern uses AI across its products, including Ask Fern, indexing, MCP, AI-generated examples, Fern Writer, dashboard capabilities, and SDK tooling. The page lists the providers and model families, data processed and stored, retention behavior, and controls for turning features off. + + diff --git a/fern/products/home/home.yml b/fern/products/home/home.yml index ee29ac7466..fa4741921a 100644 --- a/fern/products/home/home.yml +++ b/fern/products/home/home.yml @@ -1,3 +1,5 @@ navigation: - page: Home - path: ./pages/welcome.mdx \ No newline at end of file + path: ./pages/welcome.mdx + - page: How Fern uses AI + path: ./pages/ai.mdx \ No newline at end of file diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx new file mode 100644 index 0000000000..da04af9ed8 --- /dev/null +++ b/fern/products/home/pages/ai.mdx @@ -0,0 +1,91 @@ +--- +title: How Fern uses AI +slug: ai +description: Every AI capability across Fern's products — what each one does, the models behind it, the data it processes, and the controls available to you. +--- + +Fern uses AI in three places: your documentation site, the Fern Dashboard, and the Fern CLI. This page lists every capability, the business problem it solves, the models that process the data, what Fern stores, and how to turn each one off. Setup instructions live on the individual feature pages linked throughout. + +Everything on this page is opt-in at the organization level or configurable in `docs.yml`. Fern products contain no AI capability that activates without a documented setting. + +## Your documentation site + +| Capability | What it does | Business use case | +| --- | --- | --- | +| [Ask Fern](/learn/docs/ai-features/ask-fern/overview) | Answers end-user questions from your indexed documentation, with citations. Available as an in-docs chat widget, [standalone React widgets](/learn/docs/ai-features/ask-fern/search-widget), and an [API](/learn/docs/ai-features/ask-fern/api-reference/overview). | Deflects support tickets and shortens onboarding by answering product questions at the point of confusion. | +| [Ask Fern Slack app](/learn/docs/ai-features/ask-fern/slack-app) | Answers questions in community and customer Slack channels, and turns human answers into indexed FAQ pairs. | Extends documentation coverage to the channel where customers already ask, and captures tribal knowledge as reusable content. | +| [MCP server](/learn/docs/ai-features/mcp-server) | Exposes a `searchDocs` tool so AI clients like Claude Code, Cursor, and Windsurf can query your documentation from a developer's environment. | Puts your documentation inside the coding agents developers build with, without them leaving the IDE. | +| Search suggestions | Generates follow-up question suggestions in the search modal from indexed search results. | Surfaces the questions users don't know to ask, which increases search engagement. | +| [AI-generated examples](/learn/docs/ai-features/ai-examples) | Replaces placeholder values in API Reference examples with realistic data derived from your OpenAPI spec. | Makes endpoints copy-paste runnable without an author hand-writing an example per endpoint. Hand-written examples always take precedence. | +| [Fern Writer](/learn/docs/ai-features/fern-writer) | Opens pull requests with targeted documentation edits when tagged in Slack. | Converts a support answer or bug report into a documentation fix without an author picking up a ticket. | +| [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview) | Clusters end-user queries into themes, summarizes each cluster as a suggested improvement, and classifies conversations as resolved or unresolved. | Shows which gaps in your documentation cost you support volume. | + +### Features that use no model + +Fern generates the following from your content deterministically. No model call and no data leaving Fern is involved: + + + + + + + + + + +These features make your published content cheaper for third-party AI tools to consume. Whether those tools can crawl or train on it depends on your [`robots.txt`](/learn/docs/seo/robots-txt), which Fern also generates. + +## Fern Dashboard + +| Capability | What it does | Business use case | +| --- | --- | --- | +| Site import | Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. | Removes the manual restructuring work in a migration from another documentation platform. | +| Brand extraction | Reads a public URL and proposes colors, typography, and logos for your docs site. | Produces an on-brand site in one step instead of a theming pass. | +| Pull request summaries | Generates a title and description for documentation pull requests from the diff. | Gives reviewers a readable change summary for edits made in [Fern Editor](/learn/docs/writing-content/fern-editor). | +| Fern Editor agent | Answers questions and drafts documentation edits against your docs site from the dashboard. Beta. | Lets non-technical authors make correct changes without learning the repository layout. | + +## Fern CLI and SDKs + +SDK and documentation generation is deterministic: the generators transform your API definition without calling a model, so the same input always produces the same output. Two CLI capabilities are explicitly AI-backed and run only when invoked: + +- `fern sdk-diff` and auto-versioning analyze the diff between two generated SDKs to propose a semantic version bump, commit message, and changelog entry. This replaces a manual release review per SDK per language. +- `fern mcp install` registers Fern's authoring MCP server with Claude Code, Cursor, or Codex, so a coding agent can work against your Fern configuration. + +## Models and providers + +Fern routes model calls to Anthropic and OpenAI. Anthropic traffic runs against the Anthropic API with AWS Bedrock as a fallback. Embeddings run through an OpenAI-compatible gateway. Model versions change as providers ship new ones. + +| Capability | Provider | Model family | +| --- | --- | --- | +| Ask Fern answers (chat, API, Slack, MCP) | Anthropic, or AWS Bedrock as fallback | Claude Sonnet, Claude Haiku | +| Ask Fern indexing and retrieval | OpenAI (embeddings), Turbopuffer (vector and keyword index), Algolia (keyword search) | `text-embedding-3-large` | +| Search suggestions | Anthropic | Claude Haiku | +| AI-generated examples | Anthropic or OpenAI, depending on the generation path | Claude, `gpt-4.1-mini` | +| Fern Writer | Anthropic, through Fern's Devin integration | Claude | +| Ask Fern analytics | OpenAI (cluster summaries), Anthropic (conversation classification) | `gpt-4.1-2025-04-14`, Claude Haiku | +| Site import, brand extraction, pull request summaries, Fern Editor agent | Anthropic, or AWS Bedrock as fallback | Claude Sonnet, Claude Opus | +| `fern sdk-diff` and auto-versioning | Anthropic, OpenAI, or AWS Bedrock | Claude Sonnet, `gpt-4o` | + +## Data Fern sends and stores + +What reaches a model depends on the capability: + +- **Ask Fern** sends the conversation, the documentation passages retrieved for the question, the site domain, and any system prompt you configure. Retrieval is filtered by the viewer's [roles](/learn/docs/authentication/features/rbac), so a viewer's answer is drawn only from content that viewer can read. +- **AI-generated examples** send endpoint metadata, the relevant part of your OpenAPI spec, and existing examples. +- **Dashboard capabilities** send the page content, public URL, or diff relevant to the request, plus your organization and docs site context. +- **`fern sdk-diff`** sends the SDK diff and prior version and changelog context. + +Fern stores end-user queries and answers to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview), including questions asked in Slack. Queries are retained indefinitely unless you set a retention window between 1 and 3650 days in the dashboard, after which older queries are purged and drop out of analytics. Product telemetry records model, token counts, and latency rather than prompt text. + +Fern doesn't use your documentation content, your code, or your end users' queries to train AI models, and configures its Devin integration for Fern Writer to opt out of data collection for model training. + +## Turning features off + +| Feature | Control | +| --- | --- | +| Ask Fern, including the Slack app and MCP server | Select **Disable** on the Ask AI card in **Settings** in the [dashboard](https://dashboard.buildwithfern.com/). | +| MCP server only | Set [`page-actions.options.mcp`](/learn/docs/configuration/site-level-settings#page-actionsoptions.mcp) to `false` in `docs.yml`. | +| AI-generated examples | Disable generation, or override individual examples, from the [AI-generated examples](/learn/docs/ai-features/ai-examples) page. | +| Query retention | Set a retention window in **Settings** > **Query log retention** in the [dashboard](https://dashboard.buildwithfern.com/). | +| Third-party AI crawling and training of your published site | Configure [`robots.txt`](/learn/docs/seo/robots-txt). | +| AI usage overall | AI features consume [credits](/learn/docs/ai-features/overview#ai-credits). Usage is visible per feature in the dashboard. | diff --git a/fern/products/home/pages/welcome.mdx b/fern/products/home/pages/welcome.mdx index c7d982f404..fdce17faa0 100644 --- a/fern/products/home/pages/welcome.mdx +++ b/fern/products/home/pages/welcome.mdx @@ -202,6 +202,11 @@ layout: custom Configure Arrow right light Arrow right light + + + How Fern uses AI + Arrow right light + Arrow right light Customers From d32df25cb52d8587cbb1e86f2e3fb8edab4ea1aa Mon Sep 17 00:00:00 2001 From: "rishabh.dhadda" Date: Mon, 24 Aug 2026 19:02:48 +0000 Subject: [PATCH 02/12] docs: clarify AI capability controls Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/pages/ai.mdx | 4 ++-- fern/products/home/pages/welcome.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx index da04af9ed8..612f4dbb48 100644 --- a/fern/products/home/pages/ai.mdx +++ b/fern/products/home/pages/ai.mdx @@ -6,7 +6,7 @@ description: Every AI capability across Fern's products — what each one does, Fern uses AI in three places: your documentation site, the Fern Dashboard, and the Fern CLI. This page lists every capability, the business problem it solves, the models that process the data, what Fern stores, and how to turn each one off. Setup instructions live on the individual feature pages linked throughout. -Everything on this page is opt-in at the organization level or configurable in `docs.yml`. Fern products contain no AI capability that activates without a documented setting. +Ask Fern and its Slack app require enablement. Fern's deterministic features are always on. Dashboard and CLI capabilities run only when a user invokes them. ## Your documentation site @@ -84,7 +84,7 @@ Fern doesn't use your documentation content, your code, or your end users' queri | Feature | Control | | --- | --- | | Ask Fern, including the Slack app and MCP server | Select **Disable** on the Ask AI card in **Settings** in the [dashboard](https://dashboard.buildwithfern.com/). | -| MCP server only | Set [`page-actions.options.mcp`](/learn/docs/configuration/site-level-settings#page-actionsoptions.mcp) to `false` in `docs.yml`. | +| MCP server only | Set [`page-actions.options.mcp`](/learn/docs/configuration/site-level-settings#page-actionsoptionsmcp) to `false` in `docs.yml`. | | AI-generated examples | Disable generation, or override individual examples, from the [AI-generated examples](/learn/docs/ai-features/ai-examples) page. | | Query retention | Set a retention window in **Settings** > **Query log retention** in the [dashboard](https://dashboard.buildwithfern.com/). | | Third-party AI crawling and training of your published site | Configure [`robots.txt`](/learn/docs/seo/robots-txt). | diff --git a/fern/products/home/pages/welcome.mdx b/fern/products/home/pages/welcome.mdx index fdce17faa0..7172358738 100644 --- a/fern/products/home/pages/welcome.mdx +++ b/fern/products/home/pages/welcome.mdx @@ -203,7 +203,7 @@ layout: custom Arrow right light Arrow right light - + How Fern uses AI Arrow right light Arrow right light From 26b98cd54ef75fdd872b6a7a1457a53d7b146208 Mon Sep 17 00:00:00 2001 From: "rishabh.dhadda" Date: Thu, 27 Aug 2026 17:33:13 +0000 Subject: [PATCH 03/12] docs: drop model and provider details from AI overview Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .../docs/pages/changelog/2026-08-24.mdx | 2 +- fern/products/home/pages/ai.mdx | 19 ++----------------- 2 files changed, 3 insertions(+), 18 deletions(-) diff --git a/fern/products/docs/pages/changelog/2026-08-24.mdx b/fern/products/docs/pages/changelog/2026-08-24.mdx index 9eb3bcb72d..2ff1c77c84 100644 --- a/fern/products/docs/pages/changelog/2026-08-24.mdx +++ b/fern/products/docs/pages/changelog/2026-08-24.mdx @@ -10,6 +10,6 @@ You can now iterate on library docs locally from `git` inputs, not just `path` i ai -You can now review how Fern uses AI across its products, including Ask Fern, indexing, MCP, AI-generated examples, Fern Writer, dashboard capabilities, and SDK tooling. The page lists the providers and model families, data processed and stored, retention behavior, and controls for turning features off. +You can now review how Fern uses AI across its products, including Ask Fern, indexing, MCP, AI-generated examples, Fern Writer, dashboard capabilities, and SDK tooling. The page lists the business use case for each capability, the data processed and stored, retention behavior, and controls for turning features off. diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx index 612f4dbb48..b6dada42f0 100644 --- a/fern/products/home/pages/ai.mdx +++ b/fern/products/home/pages/ai.mdx @@ -1,10 +1,10 @@ --- title: How Fern uses AI slug: ai -description: Every AI capability across Fern's products — what each one does, the models behind it, the data it processes, and the controls available to you. +description: Every AI capability across Fern's products, what it does for your team, the data it processes, and the controls available to you. --- -Fern uses AI in three places: your documentation site, the Fern Dashboard, and the Fern CLI. This page lists every capability, the business problem it solves, the models that process the data, what Fern stores, and how to turn each one off. Setup instructions live on the individual feature pages linked throughout. +Fern uses AI in three places: your documentation site, the Fern Dashboard, and the Fern CLI. This page lists every capability, the business problem it solves, what Fern stores, and how to turn each one off. Setup instructions live on the individual feature pages linked throughout. Ask Fern and its Slack app require enablement. Fern's deterministic features are always on. Dashboard and CLI capabilities run only when a user invokes them. @@ -51,21 +51,6 @@ SDK and documentation generation is deterministic: the generators transform your - `fern sdk-diff` and auto-versioning analyze the diff between two generated SDKs to propose a semantic version bump, commit message, and changelog entry. This replaces a manual release review per SDK per language. - `fern mcp install` registers Fern's authoring MCP server with Claude Code, Cursor, or Codex, so a coding agent can work against your Fern configuration. -## Models and providers - -Fern routes model calls to Anthropic and OpenAI. Anthropic traffic runs against the Anthropic API with AWS Bedrock as a fallback. Embeddings run through an OpenAI-compatible gateway. Model versions change as providers ship new ones. - -| Capability | Provider | Model family | -| --- | --- | --- | -| Ask Fern answers (chat, API, Slack, MCP) | Anthropic, or AWS Bedrock as fallback | Claude Sonnet, Claude Haiku | -| Ask Fern indexing and retrieval | OpenAI (embeddings), Turbopuffer (vector and keyword index), Algolia (keyword search) | `text-embedding-3-large` | -| Search suggestions | Anthropic | Claude Haiku | -| AI-generated examples | Anthropic or OpenAI, depending on the generation path | Claude, `gpt-4.1-mini` | -| Fern Writer | Anthropic, through Fern's Devin integration | Claude | -| Ask Fern analytics | OpenAI (cluster summaries), Anthropic (conversation classification) | `gpt-4.1-2025-04-14`, Claude Haiku | -| Site import, brand extraction, pull request summaries, Fern Editor agent | Anthropic, or AWS Bedrock as fallback | Claude Sonnet, Claude Opus | -| `fern sdk-diff` and auto-versioning | Anthropic, OpenAI, or AWS Bedrock | Claude Sonnet, `gpt-4o` | - ## Data Fern sends and stores What reaches a model depends on the capability: From f78f659cfaaef8ab5cbee7ae5a446767cd0a18aa Mon Sep 17 00:00:00 2001 From: "rishabh.dhadda" Date: Thu, 27 Aug 2026 17:51:02 +0000 Subject: [PATCH 04/12] docs: clarify Fern agent capability Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/home/pages/ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx index b6dada42f0..779b3962ca 100644 --- a/fern/products/home/pages/ai.mdx +++ b/fern/products/home/pages/ai.mdx @@ -42,7 +42,7 @@ These features make your published content cheaper for third-party AI tools to c | Site import | Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. | Removes the manual restructuring work in a migration from another documentation platform. | | Brand extraction | Reads a public URL and proposes colors, typography, and logos for your docs site. | Produces an on-brand site in one step instead of a theming pass. | | Pull request summaries | Generates a title and description for documentation pull requests from the diff. | Gives reviewers a readable change summary for edits made in [Fern Editor](/learn/docs/writing-content/fern-editor). | -| Fern Editor agent | Answers questions and drafts documentation edits against your docs site from the dashboard. Beta. | Lets non-technical authors make correct changes without learning the repository layout. | +| Fern agent | Answers questions about your docs site and its configuration, queries your documentation analytics, and makes documentation edits that land as a [Fern Editor](/learn/docs/writing-content/fern-editor) draft or a pull request. Also available in Slack. Beta. | Gives any team member a single place to ask what the docs say, how they're performing, and to get a change made without learning the repository layout. | ## Fern CLI and SDKs From 2e094335c2221831cb0d78515126dd3541d9afcd Mon Sep 17 00:00:00 2001 From: "rishabh.dhadda" Date: Thu, 27 Aug 2026 20:16:02 +0000 Subject: [PATCH 05/12] docs: scope AI overview claims to launched functionality Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/overview.mdx | 2 +- fern/products/home/pages/ai.mdx | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index cfa893b337..4aa51ac7cd 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -4,7 +4,7 @@ description: Fern AI features help users find answers instantly, automate conten --- -Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. For the full picture across every Fern product, including the models behind each feature and the data they process, see [how Fern uses AI](/learn/home/ai). +Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. For the full picture across every Fern product, including the business use case for each feature and the data it processes, see [how Fern uses AI](/learn/home/ai). diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx index 779b3962ca..a507698712 100644 --- a/fern/products/home/pages/ai.mdx +++ b/fern/products/home/pages/ai.mdx @@ -15,10 +15,10 @@ Ask Fern and its Slack app require enablement. Fern's deterministic features are | [Ask Fern](/learn/docs/ai-features/ask-fern/overview) | Answers end-user questions from your indexed documentation, with citations. Available as an in-docs chat widget, [standalone React widgets](/learn/docs/ai-features/ask-fern/search-widget), and an [API](/learn/docs/ai-features/ask-fern/api-reference/overview). | Deflects support tickets and shortens onboarding by answering product questions at the point of confusion. | | [Ask Fern Slack app](/learn/docs/ai-features/ask-fern/slack-app) | Answers questions in community and customer Slack channels, and turns human answers into indexed FAQ pairs. | Extends documentation coverage to the channel where customers already ask, and captures tribal knowledge as reusable content. | | [MCP server](/learn/docs/ai-features/mcp-server) | Exposes a `searchDocs` tool so AI clients like Claude Code, Cursor, and Windsurf can query your documentation from a developer's environment. | Puts your documentation inside the coding agents developers build with, without them leaving the IDE. | -| Search suggestions | Generates follow-up question suggestions in the search modal from indexed search results. | Surfaces the questions users don't know to ask, which increases search engagement. | +| Search suggestions | Generates follow-up question suggestions in the search modal from indexed search results. Requires Ask Fern. | Surfaces the questions users don't know to ask, which increases search engagement. | | [AI-generated examples](/learn/docs/ai-features/ai-examples) | Replaces placeholder values in API Reference examples with realistic data derived from your OpenAPI spec. | Makes endpoints copy-paste runnable without an author hand-writing an example per endpoint. Hand-written examples always take precedence. | | [Fern Writer](/learn/docs/ai-features/fern-writer) | Opens pull requests with targeted documentation edits when tagged in Slack. | Converts a support answer or bug report into a documentation fix without an author picking up a ticket. | -| [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview) | Clusters end-user queries into themes, summarizes each cluster as a suggested improvement, and classifies conversations as resolved or unresolved. | Shows which gaps in your documentation cost you support volume. | +| [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview) | Reports conversation volume, per-conversation drill-down, CSV export, and a resolution rate: the share of conversations where Ask Fern returned a cited answer. | Shows which gaps in your documentation cost you support volume. | ### Features that use no model @@ -42,7 +42,7 @@ These features make your published content cheaper for third-party AI tools to c | Site import | Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. | Removes the manual restructuring work in a migration from another documentation platform. | | Brand extraction | Reads a public URL and proposes colors, typography, and logos for your docs site. | Produces an on-brand site in one step instead of a theming pass. | | Pull request summaries | Generates a title and description for documentation pull requests from the diff. | Gives reviewers a readable change summary for edits made in [Fern Editor](/learn/docs/writing-content/fern-editor). | -| Fern agent | Answers questions about your docs site and its configuration, queries your documentation analytics, and makes documentation edits that land as a [Fern Editor](/learn/docs/writing-content/fern-editor) draft or a pull request. Also available in Slack. Beta. | Gives any team member a single place to ask what the docs say, how they're performing, and to get a change made without learning the repository layout. | +| Fern agent | Answers questions about your docs site and its configuration, queries your documentation analytics, and makes documentation edits that land as a [Fern Editor](/learn/docs/writing-content/fern-editor) draft or a pull request. Also available in Slack. Beta, enabled for selected organizations. | Gives any team member a single place to ask what the docs say, how they're performing, and to get a change made without learning the repository layout. | ## Fern CLI and SDKs @@ -60,7 +60,7 @@ What reaches a model depends on the capability: - **Dashboard capabilities** send the page content, public URL, or diff relevant to the request, plus your organization and docs site context. - **`fern sdk-diff`** sends the SDK diff and prior version and changelog context. -Fern stores end-user queries and answers to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview), including questions asked in Slack. Queries are retained indefinitely unless you set a retention window between 1 and 3650 days in the dashboard, after which older queries are purged and drop out of analytics. Product telemetry records model, token counts, and latency rather than prompt text. +Fern stores end-user queries and answers to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview), including questions asked in Slack. Queries are retained indefinitely unless you enable query log purging in the dashboard and set a retention window between 1 and 3650 days, after which older queries are purged and drop out of analytics. Product telemetry records token counts and latency rather than prompt text. Fern doesn't use your documentation content, your code, or your end users' queries to train AI models, and configures its Devin integration for Fern Writer to opt out of data collection for model training. @@ -73,4 +73,4 @@ Fern doesn't use your documentation content, your code, or your end users' queri | AI-generated examples | Disable generation, or override individual examples, from the [AI-generated examples](/learn/docs/ai-features/ai-examples) page. | | Query retention | Set a retention window in **Settings** > **Query log retention** in the [dashboard](https://dashboard.buildwithfern.com/). | | Third-party AI crawling and training of your published site | Configure [`robots.txt`](/learn/docs/seo/robots-txt). | -| AI usage overall | AI features consume [credits](/learn/docs/ai-features/overview#ai-credits). Usage is visible per feature in the dashboard. | +| AI usage overall | Ask Fern, AI-generated examples, and Fern Writer consume [credits](/learn/docs/ai-features/overview#ai-credits) against your plan's monthly allowance. | From acb52416907691db52e923c73d5faab998046ced Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 13:57:07 +0000 Subject: [PATCH 06/12] docs: fold AI data and controls into AI features and dashboard overviews Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/dashboard/pages/overview.mdx | 42 ++++++++++ fern/products/docs/pages/ai/overview.mdx | 21 ++++- .../docs/pages/changelog/2026-08-24.mdx | 8 -- .../docs/pages/changelog/2026-09-08.mdx | 7 ++ fern/products/home/home.yml | 4 +- fern/products/home/pages/ai.mdx | 76 ------------------- fern/products/home/pages/welcome.mdx | 5 -- 7 files changed, 69 insertions(+), 94 deletions(-) create mode 100644 fern/products/docs/pages/changelog/2026-09-08.mdx delete mode 100644 fern/products/home/pages/ai.mdx diff --git a/fern/products/dashboard/pages/overview.mdx b/fern/products/dashboard/pages/overview.mdx index 2e4a2baf30..e5d221d0e9 100644 --- a/fern/products/dashboard/pages/overview.mdx +++ b/fern/products/dashboard/pages/overview.mdx @@ -191,6 +191,39 @@ Manage your documentation site and team collaboration: Temporarily take a site offline without deleting it. + +## AI features + +The dashboard uses AI in these places. Each runs only when you invoke it, and the page content, URL, or diff you provide is sent to a model along with your organization and site context. Fern doesn't use this data to train AI models. + + + + Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. + + + Reads a public URL and proposes colors, typography, and logos for your docs site. + + + Generates a title and description for pull requests opened from Fern Editor. + + + Answers questions about your site, configuration, and analytics, and makes edits as a Fern Editor draft or pull request. + + @@ -228,5 +261,14 @@ Manage your documentation site and team collaboration: - [Password protection](/learn/dashboard/configuration/password-protection): Restrict access to your docs site with a shared password. - [Query log retention](/learn/docs/ai-features/ask-fern/overview#features): Purge Ask Fern end-user query logs on a schedule instead of keeping them indefinitely. - [Unpublish a site](/learn/docs/preview-publish/publishing-your-docs#unpublishing-your-docs): Temporarily take a site offline without deleting it. + +## AI features + +The dashboard uses AI in these places. Each runs only when you invoke it, and the page content, URL, or diff you provide is sent to a model along with your organization and site context. Fern doesn't use this data to train AI models. + +- **Site import**: Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. +- **Brand extraction**: Reads a public URL and proposes colors, typography, and logos for your docs site. +- [Pull request summaries](/learn/docs/writing-content/fern-editor): Generates a title and description for pull requests opened from Fern Editor. +- [Fern Agent](/learn/docs/ai-features/fern-agent): Answers questions about your site, configuration, and analytics, and makes edits as a Fern Editor draft or pull request. diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index dd4762b6fe..00bbb10231 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -4,7 +4,7 @@ description: Fern AI features help users find answers instantly, automate conten --- -Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. For the full picture across every Fern product, including the business use case for each feature and the data it processes, see [how Fern uses AI](/learn/home/ai). +Your documentation site comes with automatic optimizations for AI tools, plus features you can install to help users find answers and keep your content up to date. @@ -43,7 +43,7 @@ You can hand your docs to an agent. [Fern Agent](/learn/docs/ai-features/fern-ag ## Optimize for AI -Your site is automatically optimized for AI tools and search engines. Fern hosts an `llms.txt` file so LLMs can index your documentation efficiently, serves Markdown instead of HTML to AI agents, and exposes a standards-based API catalog for automated discovery. These features reduce token consumption and help agents process your content faster. +Your site is automatically optimized for AI tools and search engines. Fern hosts an `llms.txt` file so LLMs can index your documentation efficiently, serves Markdown instead of HTML to AI agents, and exposes a standards-based API catalog for automated discovery. These features reduce token consumption and help agents process your content faster. They're generated deterministically from your content: no model is called and no data leaves Fern. Whether third-party tools can crawl or train on your published site is governed by your [`robots.txt`](/learn/docs/seo/robots-txt). @@ -51,3 +51,20 @@ Your site is automatically optimized for AI tools and search engines. Fern hosts + +## Data and controls + +What reaches a model depends on the feature: + +- **Ask Fern** sends the conversation, the documentation passages retrieved for the question, the site domain, and any system prompt you configure. Retrieval respects the viewer's [roles](/learn/docs/authentication/features/rbac), so answers draw only from content that viewer can read. Fern stores end-user queries and answers, including questions asked in Slack, to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview#features), and retains them indefinitely unless you set a query log retention window in the dashboard. +- **AI-generated examples** send endpoint metadata, the relevant part of your API definition, and existing examples. +- **Fern Agent** sends your prompt, the Slack thread it's tagged in, and attached files, and [stores them only during the session](/learn/docs/ai-features/fern-agent#privacy-and-data-handling). + +Fern doesn't use your documentation content, your code, or your end users' queries to train AI models. + +| Feature | How to turn it off | +| --- | --- | +| Ask Fern, including the Slack app and MCP server | Select [**Disable** on the Ask AI card](/learn/docs/ai-features/ask-fern/overview#disable-ask-fern) in **Settings** in the [dashboard](https://dashboard.buildwithfern.com/). | +| MCP server only | Set [`page-actions.options.mcp`](/learn/docs/configuration/site-level-settings#page-actionsoptions.mcp) to `false` in `docs.yml`. | +| AI-generated examples | Set [`ai-examples.enabled`](/learn/docs/ai-features/ai-examples#disable-ai-generated-examples) to `false` in `docs.yml`. Hand-written examples always take precedence. | +| Third-party AI crawling of your published site | Configure [`robots.txt`](/learn/docs/seo/robots-txt). | diff --git a/fern/products/docs/pages/changelog/2026-08-24.mdx b/fern/products/docs/pages/changelog/2026-08-24.mdx index 2ff1c77c84..df686a424b 100644 --- a/fern/products/docs/pages/changelog/2026-08-24.mdx +++ b/fern/products/docs/pages/changelog/2026-08-24.mdx @@ -5,11 +5,3 @@ You can now iterate on library docs locally from `git` inputs, not just `path` inputs. `fern docs md generate --local` reads the library source from the repository at the configured `ref` and parses it on your machine, so you can preview generated pages without publishing or logging in to Fern. - -## How Fern uses AI - -ai - -You can now review how Fern uses AI across its products, including Ask Fern, indexing, MCP, AI-generated examples, Fern Writer, dashboard capabilities, and SDK tooling. The page lists the business use case for each capability, the data processed and stored, retention behavior, and controls for turning features off. - - diff --git a/fern/products/docs/pages/changelog/2026-09-08.mdx b/fern/products/docs/pages/changelog/2026-09-08.mdx new file mode 100644 index 0000000000..4ac9af8af9 --- /dev/null +++ b/fern/products/docs/pages/changelog/2026-09-08.mdx @@ -0,0 +1,7 @@ +## AI data and controls + +ai + +The AI features overview now documents what each AI feature sends to a model, what Fern stores and for how long, and how to turn each feature off. The dashboard overview lists the AI features available in the Fern Dashboard. + + diff --git a/fern/products/home/home.yml b/fern/products/home/home.yml index fa4741921a..ee29ac7466 100644 --- a/fern/products/home/home.yml +++ b/fern/products/home/home.yml @@ -1,5 +1,3 @@ navigation: - page: Home - path: ./pages/welcome.mdx - - page: How Fern uses AI - path: ./pages/ai.mdx \ No newline at end of file + path: ./pages/welcome.mdx \ No newline at end of file diff --git a/fern/products/home/pages/ai.mdx b/fern/products/home/pages/ai.mdx deleted file mode 100644 index a507698712..0000000000 --- a/fern/products/home/pages/ai.mdx +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: How Fern uses AI -slug: ai -description: Every AI capability across Fern's products, what it does for your team, the data it processes, and the controls available to you. ---- - -Fern uses AI in three places: your documentation site, the Fern Dashboard, and the Fern CLI. This page lists every capability, the business problem it solves, what Fern stores, and how to turn each one off. Setup instructions live on the individual feature pages linked throughout. - -Ask Fern and its Slack app require enablement. Fern's deterministic features are always on. Dashboard and CLI capabilities run only when a user invokes them. - -## Your documentation site - -| Capability | What it does | Business use case | -| --- | --- | --- | -| [Ask Fern](/learn/docs/ai-features/ask-fern/overview) | Answers end-user questions from your indexed documentation, with citations. Available as an in-docs chat widget, [standalone React widgets](/learn/docs/ai-features/ask-fern/search-widget), and an [API](/learn/docs/ai-features/ask-fern/api-reference/overview). | Deflects support tickets and shortens onboarding by answering product questions at the point of confusion. | -| [Ask Fern Slack app](/learn/docs/ai-features/ask-fern/slack-app) | Answers questions in community and customer Slack channels, and turns human answers into indexed FAQ pairs. | Extends documentation coverage to the channel where customers already ask, and captures tribal knowledge as reusable content. | -| [MCP server](/learn/docs/ai-features/mcp-server) | Exposes a `searchDocs` tool so AI clients like Claude Code, Cursor, and Windsurf can query your documentation from a developer's environment. | Puts your documentation inside the coding agents developers build with, without them leaving the IDE. | -| Search suggestions | Generates follow-up question suggestions in the search modal from indexed search results. Requires Ask Fern. | Surfaces the questions users don't know to ask, which increases search engagement. | -| [AI-generated examples](/learn/docs/ai-features/ai-examples) | Replaces placeholder values in API Reference examples with realistic data derived from your OpenAPI spec. | Makes endpoints copy-paste runnable without an author hand-writing an example per endpoint. Hand-written examples always take precedence. | -| [Fern Writer](/learn/docs/ai-features/fern-writer) | Opens pull requests with targeted documentation edits when tagged in Slack. | Converts a support answer or bug report into a documentation fix without an author picking up a ticket. | -| [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview) | Reports conversation volume, per-conversation drill-down, CSV export, and a resolution rate: the share of conversations where Ask Fern returned a cited answer. | Shows which gaps in your documentation cost you support volume. | - -### Features that use no model - -Fern generates the following from your content deterministically. No model call and no data leaving Fern is involved: - - - - - - - - - - -These features make your published content cheaper for third-party AI tools to consume. Whether those tools can crawl or train on it depends on your [`robots.txt`](/learn/docs/seo/robots-txt), which Fern also generates. - -## Fern Dashboard - -| Capability | What it does | Business use case | -| --- | --- | --- | -| Site import | Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding. | Removes the manual restructuring work in a migration from another documentation platform. | -| Brand extraction | Reads a public URL and proposes colors, typography, and logos for your docs site. | Produces an on-brand site in one step instead of a theming pass. | -| Pull request summaries | Generates a title and description for documentation pull requests from the diff. | Gives reviewers a readable change summary for edits made in [Fern Editor](/learn/docs/writing-content/fern-editor). | -| Fern agent | Answers questions about your docs site and its configuration, queries your documentation analytics, and makes documentation edits that land as a [Fern Editor](/learn/docs/writing-content/fern-editor) draft or a pull request. Also available in Slack. Beta, enabled for selected organizations. | Gives any team member a single place to ask what the docs say, how they're performing, and to get a change made without learning the repository layout. | - -## Fern CLI and SDKs - -SDK and documentation generation is deterministic: the generators transform your API definition without calling a model, so the same input always produces the same output. Two CLI capabilities are explicitly AI-backed and run only when invoked: - -- `fern sdk-diff` and auto-versioning analyze the diff between two generated SDKs to propose a semantic version bump, commit message, and changelog entry. This replaces a manual release review per SDK per language. -- `fern mcp install` registers Fern's authoring MCP server with Claude Code, Cursor, or Codex, so a coding agent can work against your Fern configuration. - -## Data Fern sends and stores - -What reaches a model depends on the capability: - -- **Ask Fern** sends the conversation, the documentation passages retrieved for the question, the site domain, and any system prompt you configure. Retrieval is filtered by the viewer's [roles](/learn/docs/authentication/features/rbac), so a viewer's answer is drawn only from content that viewer can read. -- **AI-generated examples** send endpoint metadata, the relevant part of your OpenAPI spec, and existing examples. -- **Dashboard capabilities** send the page content, public URL, or diff relevant to the request, plus your organization and docs site context. -- **`fern sdk-diff`** sends the SDK diff and prior version and changelog context. - -Fern stores end-user queries and answers to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview), including questions asked in Slack. Queries are retained indefinitely unless you enable query log purging in the dashboard and set a retention window between 1 and 3650 days, after which older queries are purged and drop out of analytics. Product telemetry records token counts and latency rather than prompt text. - -Fern doesn't use your documentation content, your code, or your end users' queries to train AI models, and configures its Devin integration for Fern Writer to opt out of data collection for model training. - -## Turning features off - -| Feature | Control | -| --- | --- | -| Ask Fern, including the Slack app and MCP server | Select **Disable** on the Ask AI card in **Settings** in the [dashboard](https://dashboard.buildwithfern.com/). | -| MCP server only | Set [`page-actions.options.mcp`](/learn/docs/configuration/site-level-settings#page-actionsoptionsmcp) to `false` in `docs.yml`. | -| AI-generated examples | Disable generation, or override individual examples, from the [AI-generated examples](/learn/docs/ai-features/ai-examples) page. | -| Query retention | Set a retention window in **Settings** > **Query log retention** in the [dashboard](https://dashboard.buildwithfern.com/). | -| Third-party AI crawling and training of your published site | Configure [`robots.txt`](/learn/docs/seo/robots-txt). | -| AI usage overall | Ask Fern, AI-generated examples, and Fern Writer consume [credits](/learn/docs/ai-features/overview#ai-credits) against your plan's monthly allowance. | diff --git a/fern/products/home/pages/welcome.mdx b/fern/products/home/pages/welcome.mdx index 7172358738..c7d982f404 100644 --- a/fern/products/home/pages/welcome.mdx +++ b/fern/products/home/pages/welcome.mdx @@ -203,11 +203,6 @@ layout: custom Arrow right light Arrow right light - - How Fern uses AI - Arrow right light - Arrow right light - Customers Arrow right light From 8bcbff898192af589ef563b2fef674f76f777b3b Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:01:07 +0000 Subject: [PATCH 07/12] docs: move per-feature AI data handling to feature pages Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/ai-examples.mdx | 2 ++ fern/products/docs/pages/ai/overview.mdx | 8 +------- fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx | 4 ++++ fern/products/docs/pages/changelog/2026-09-08.mdx | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/fern/products/docs/pages/ai/ai-examples.mdx b/fern/products/docs/pages/ai/ai-examples.mdx index 2170e836b5..344262c344 100644 --- a/fern/products/docs/pages/ai/ai-examples.mdx +++ b/fern/products/docs/pages/ai/ai-examples.mdx @@ -9,6 +9,8 @@ Fern uses AI to automatically generate realistic request and response examples f AI examples work alongside manual examples defined in [`x-fern-examples`](/learn/api-definitions/openapi/extensions/request-response-examples), with manual examples taking priority. +Generation sends endpoint metadata, the relevant part of your API definition, and existing examples to the model. Fern doesn't use your API definition to train AI models. + diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index 00bbb10231..6b94888169 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -54,13 +54,7 @@ Your site is automatically optimized for AI tools and search engines. Fern hosts ## Data and controls -What reaches a model depends on the feature: - -- **Ask Fern** sends the conversation, the documentation passages retrieved for the question, the site domain, and any system prompt you configure. Retrieval respects the viewer's [roles](/learn/docs/authentication/features/rbac), so answers draw only from content that viewer can read. Fern stores end-user queries and answers, including questions asked in Slack, to power [Ask Fern analytics](/learn/docs/ai-features/ask-fern/overview#features), and retains them indefinitely unless you set a query log retention window in the dashboard. -- **AI-generated examples** send endpoint metadata, the relevant part of your API definition, and existing examples. -- **Fern Agent** sends your prompt, the Slack thread it's tagged in, and attached files, and [stores them only during the session](/learn/docs/ai-features/fern-agent#privacy-and-data-handling). - -Fern doesn't use your documentation content, your code, or your end users' queries to train AI models. +Fern doesn't use your documentation content, your code, or your end users' queries to train AI models. Each feature page documents what it sends to a model and what Fern stores: [Ask Fern](/learn/docs/ai-features/ask-fern/overview#privacy-and-data-handling), [AI-generated examples](/learn/docs/ai-features/ai-examples), and [Fern Agent](/learn/docs/ai-features/fern-agent#privacy-and-data-handling). | Feature | How to turn it off | | --- | --- | diff --git a/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx b/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx index f9a1196a24..12be79ac1c 100644 --- a/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx +++ b/fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx @@ -119,6 +119,10 @@ Ask Fern can [mask structured personally identifiable information](/learn/docs/c +## Privacy and data handling + +Each request sends the conversation, the documentation passages retrieved for the question, the site domain, and any system prompt you configure to the model. Retrieval respects the viewer's [roles](/learn/docs/authentication/features/rbac), so answers draw only from content that viewer can read. Fern stores end-user queries and answers, including questions asked in Slack, to power analytics, and retains them indefinitely unless you set a [query log retention](#features) window. Fern doesn't use your documentation content or your end users' queries to train AI models. + ## Disable Ask Fern To turn Ask Fern off, open the [Fern Dashboard](https://dashboard.buildwithfern.com/), navigate to the **Settings** tab, and click **Disable** on the Ask AI card. This removes AI search and the side panel from your site. diff --git a/fern/products/docs/pages/changelog/2026-09-08.mdx b/fern/products/docs/pages/changelog/2026-09-08.mdx index 4ac9af8af9..09cd08910f 100644 --- a/fern/products/docs/pages/changelog/2026-09-08.mdx +++ b/fern/products/docs/pages/changelog/2026-09-08.mdx @@ -2,6 +2,6 @@ ai -The AI features overview now documents what each AI feature sends to a model, what Fern stores and for how long, and how to turn each feature off. The dashboard overview lists the AI features available in the Fern Dashboard. +The AI features overview now lists how to turn each AI feature off, and the Ask Fern and AI-generated examples pages document what they send to a model and what Fern stores. The dashboard overview lists the AI features available in the Fern Dashboard. From 876ea099e8c18aa1f370b685ee0931fa0351b090 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:06:05 +0000 Subject: [PATCH 08/12] docs: drop changelog entry Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/changelog/2026-09-08.mdx | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 fern/products/docs/pages/changelog/2026-09-08.mdx diff --git a/fern/products/docs/pages/changelog/2026-09-08.mdx b/fern/products/docs/pages/changelog/2026-09-08.mdx deleted file mode 100644 index 09cd08910f..0000000000 --- a/fern/products/docs/pages/changelog/2026-09-08.mdx +++ /dev/null @@ -1,7 +0,0 @@ -## AI data and controls - -ai - -The AI features overview now lists how to turn each AI feature off, and the Ask Fern and AI-generated examples pages document what they send to a model and what Fern stores. The dashboard overview lists the AI features available in the Fern Dashboard. - - From f5c19d3c5c6182d6fe53c132d73af1181db7e5ff Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:11:24 +0000 Subject: [PATCH 09/12] docs: summarize AI data handling on overview Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/overview.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index 6b94888169..eecf87d68f 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -54,7 +54,7 @@ Your site is automatically optimized for AI tools and search engines. Fern hosts ## Data and controls -Fern doesn't use your documentation content, your code, or your end users' queries to train AI models. Each feature page documents what it sends to a model and what Fern stores: [Ask Fern](/learn/docs/ai-features/ask-fern/overview#privacy-and-data-handling), [AI-generated examples](/learn/docs/ai-features/ai-examples), and [Fern Agent](/learn/docs/ai-features/fern-agent#privacy-and-data-handling). +Only the content a feature needs reaches a model: [Ask Fern](/learn/docs/ai-features/ask-fern/overview#privacy-and-data-handling) sends the conversation and the documentation passages the viewer is allowed to read, [AI-generated examples](/learn/docs/ai-features/ai-examples) send the relevant part of your API definition, and [Fern Agent](/learn/docs/ai-features/fern-agent#privacy-and-data-handling) sends your request and keeps it only during the session. Fern stores Ask Fern queries for analytics, and doesn't use your documentation content, your code, or your end users' queries to train AI models. | Feature | How to turn it off | | --- | --- | From 00ecc8bbeec49d892b341cfe98b0d87ef8acf7d1 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:27:21 +0000 Subject: [PATCH 10/12] docs: tighten Optimize for AI intro Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/overview.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index eecf87d68f..3328599081 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -43,7 +43,9 @@ You can hand your docs to an agent. [Fern Agent](/learn/docs/ai-features/fern-ag ## Optimize for AI -Your site is automatically optimized for AI tools and search engines. Fern hosts an `llms.txt` file so LLMs can index your documentation efficiently, serves Markdown instead of HTML to AI agents, and exposes a standards-based API catalog for automated discovery. These features reduce token consumption and help agents process your content faster. They're generated deterministically from your content: no model is called and no data leaves Fern. Whether third-party tools can crawl or train on your published site is governed by your [`robots.txt`](/learn/docs/seo/robots-txt). +Your site is automatically optimized for AI tools and search engines. Fern hosts an `llms.txt` file, serves Markdown instead of HTML to AI agents, and exposes a standards-based API catalog, so agents index and process your content with fewer tokens. + +These files are generated from your content without calling a model. Your [`robots.txt`](/learn/docs/seo/robots-txt) controls whether third-party tools can crawl or train on them. From f68e241fe5274d7ea5e6ccfc9f00c8eb5c3e91c9 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:28:55 +0000 Subject: [PATCH 11/12] ci: retrigger vale after reviewdog download failure Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> From 9b2a409bd8b8b96231173827bdb8727a4b4306d2 Mon Sep 17 00:00:00 2001 From: "devin.logan" Date: Tue, 8 Sep 2026 14:32:59 +0000 Subject: [PATCH 12/12] docs: bullet the data summary Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- fern/products/docs/pages/ai/overview.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/fern/products/docs/pages/ai/overview.mdx b/fern/products/docs/pages/ai/overview.mdx index 3328599081..192278b451 100644 --- a/fern/products/docs/pages/ai/overview.mdx +++ b/fern/products/docs/pages/ai/overview.mdx @@ -56,7 +56,13 @@ These files are generated from your content without calling a model. Your [`robo ## Data and controls -Only the content a feature needs reaches a model: [Ask Fern](/learn/docs/ai-features/ask-fern/overview#privacy-and-data-handling) sends the conversation and the documentation passages the viewer is allowed to read, [AI-generated examples](/learn/docs/ai-features/ai-examples) send the relevant part of your API definition, and [Fern Agent](/learn/docs/ai-features/fern-agent#privacy-and-data-handling) sends your request and keeps it only during the session. Fern stores Ask Fern queries for analytics, and doesn't use your documentation content, your code, or your end users' queries to train AI models. +Only the content a feature needs reaches a model: + +- [Ask Fern](/learn/docs/ai-features/ask-fern/overview#privacy-and-data-handling) sends the conversation and the documentation passages the viewer is allowed to read. Fern stores queries for analytics. +- [AI-generated examples](/learn/docs/ai-features/ai-examples) send the relevant part of your API definition. +- [Fern Agent](/learn/docs/ai-features/fern-agent#privacy-and-data-handling) sends your request and keeps it only during the session. + +Fern doesn't use your documentation content, your code, or your end users' queries to train AI models. | Feature | How to turn it off | | --- | --- |