Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions fern/products/dashboard/pages/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -191,6 +191,39 @@ Manage your documentation site and team collaboration:
Temporarily take a site offline without deleting it.
</Card>
</CardGroup>

## 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.

<CardGroup cols={2}>
<Card
title="Site import"
icon="regular file-import"
>
Classifies the pages of an existing documentation site into a proposed Fern navigation structure during onboarding.
</Card>
<Card
title="Brand extraction"
icon="regular palette"
>
Reads a public URL and proposes colors, typography, and logos for your docs site.
</Card>
<Card
title="Pull request summaries"
icon="regular code-pull-request"
href="/learn/docs/writing-content/fern-editor"
>
Generates a title and description for pull requests opened from Fern Editor.
</Card>
<Card
title="Fern Agent"
icon="regular robot"
href="/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.
</Card>
</CardGroup>
</llms-ignore>

<llms-only>
Expand Down Expand Up @@ -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.
</llms-only>

2 changes: 2 additions & 0 deletions fern/products/docs/pages/ai/ai-examples.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Tabs>
<Tab title="Before">
<Frame>
Expand Down
21 changes: 20 additions & 1 deletion fern/products/docs/pages/ai/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,30 @@ 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, 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.

<CardGroup cols={2}>
<Card title="Markdown access" icon="file-code" href="/learn/docs/ai-features/markdown" />
<Card title="`llms.txt`" icon="file-text" href="/learn/docs/ai-features/llms-txt" />
<Card title="Agent directives" icon="compass" href="/learn/docs/ai-features/agent-directives" />
<Card title="API catalog discovery" icon="radar" href="/learn/docs/ai-features/api-catalog" />
</CardGroup>

## 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. 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 |
| --- | --- |
| 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). |
4 changes: 4 additions & 0 deletions fern/products/docs/pages/ask-fern/what-is-ask-fern.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,10 @@ Ask Fern can [mask structured personally identifiable information](/learn/docs/c
</Accordion>
</AccordionGroup>

## 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.
Expand Down
Loading