From a7fc9ee1375c8e1b68a7fedd193b0531517be976 Mon Sep 17 00:00:00 2001 From: Clay Tondreau Date: Wed, 5 Aug 2026 13:43:04 -0400 Subject: [PATCH 1/2] Add a "Disabling features" reference page Ask AI analytics show "how do I turn off X" is one of the most common question clusters on the docs site, and several readers had the right YAML and still couldn't get there. The settings exist but are scattered across Site settings, the API Reference layout page, and the Dashboard. Adds /learn/docs/configuration/disabling-features, a router page that collects the documented off switches and links to each canonical page. It leads with the confusion the analytics surfaced most: Ask Fern is a Dashboard toggle, `page-actions.options.ask-ai` only hides the page action button, and `ai-search` configures Ask Fern without enabling or disabling it. Also flags that the MCP server toggle lives under `page-actions` despite controlling an endpoint, and that `disable-explorer-proxy` is not an off switch for the API Explorer. Cross-links from the Configuration overview, Site settings, Ask Fern overview, and Hiding content. Co-Authored-By: Claude --- fern/products/docs/docs.yml | 3 + .../docs/pages/ask-fern/what-is-ask-fern.mdx | 2 +- .../pages/customization/hiding-content.mdx | 2 + .../pages/navigation/disabling-features.mdx | 91 +++++++++++++++++++ .../docs/pages/navigation/overview.mdx | 5 +- .../pages/navigation/site-level-settings.mdx | 2 +- 6 files changed, 102 insertions(+), 3 deletions(-) create mode 100644 fern/products/docs/pages/navigation/disabling-features.mdx diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml index 32fd453d3e..ac53952d54 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -26,6 +26,9 @@ navigation: - page: Page settings path: ./pages/navigation/frontmatter.mdx slug: page-level-settings + - page: Disabling features + path: ./pages/navigation/disabling-features.mdx + slug: disabling-features - section: Navigation skip-slug: true contents: 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 a856ff495d..a4483d7ec5 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 @@ -21,7 +21,7 @@ Ask Fern is Fern's AI Search feature, powered by [Claude 4.6 Sonnet](https://www - Open the [Fern Dashboard](https://dashboard.buildwithfern.com/). Navigate to the **Settings** tab and click **Enable** on the Ask AI card. + Open the [Fern Dashboard](https://dashboard.buildwithfern.com/). Navigate to the **Settings** tab and click **Enable** on the Ask AI card. The same card [turns Ask Fern off](/learn/docs/configuration/disabling-features#ask-fern-and-the-ask-ai-button), which is separate from hiding the **Ask AI** page action button in `docs.yml`. Enabling Ask Fern triggers an automatic reindex of your content. This typically takes a few minutes, though sites with extensive custom components may take longer. Once this process is finished, the Ask Fern side panel will appear on your site. diff --git a/fern/products/docs/pages/customization/hiding-content.mdx b/fern/products/docs/pages/customization/hiding-content.mdx index d8b7fd370e..aadd71bd5a 100644 --- a/fern/products/docs/pages/customization/hiding-content.mdx +++ b/fern/products/docs/pages/customization/hiding-content.mdx @@ -5,6 +5,8 @@ description: Control visibility of pages, sections, tabs, tab variants, versions Fern gives you two main tools for controlling content visibility: `hidden: true` in `docs.yml` removes content from your site's sidebar and search results, while `noindex: true` in page frontmatter excludes a page from search without affecting navigation. +Both control which of your content readers can reach. To turn off a built-in feature such as Ask Fern, a page action, or the API Explorer, see [Disabling features](/learn/docs/configuration/disabling-features). + ## Hiding a page ### Accessible only by direct URL diff --git a/fern/products/docs/pages/navigation/disabling-features.mdx b/fern/products/docs/pages/navigation/disabling-features.mdx new file mode 100644 index 0000000000..828a50c5b0 --- /dev/null +++ b/fern/products/docs/pages/navigation/disabling-features.mdx @@ -0,0 +1,91 @@ +--- +title: Disabling features +subtitle: Turn off Ask Fern, page actions, the MCP server, the API Explorer, and other built-in features +description: Reference for turning off built-in Fern Docs features, including which controls live in docs.yml, page frontmatter, and the Fern Dashboard. +--- + +Most Fern Docs features are on by default. Where the off switch lives depends on the feature: `docs.yml` for site-wide behavior, page frontmatter for a single page, and the [Fern Dashboard](https://dashboard.buildwithfern.com/) for [Ask Fern](/learn/docs/ai-features/ask-fern/overview). + +## Ask Fern and the Ask AI button + +Ask Fern and the **Ask AI** page action button are separate controls. + +| To turn off | Set | +|-------------|-----| +| Ask Fern itself: AI search and the side panel | **Settings** > **Ask AI** card in the Dashboard | +| The **Ask AI** page action button | `page-actions.options.ask-ai: false` in `docs.yml` | + +The [`ai-search` key](/learn/docs/configuration/site-level-settings#ask-fern-configuration) configures Ask Fern once it's enabled, setting PII masking, additional datasources, and the system prompt. It has no enable or disable property, so `ai-search: {}` leaves Ask Fern running with its default behavior. + +Setting `ask-ai: false` hides the button from the page action bar and leaves Ask Fern reachable everywhere else it appears. + +## Page actions and the MCP server + +Every built-in page action is a boolean under [`page-actions.options`](/learn/docs/configuration/site-level-settings#built-in-actions). **Copy Page**, **View as Markdown**, **Ask AI**, **ChatGPT**, **Claude**, **Claude Code**, and **Cursor** are on by default. + +```yaml title="docs.yml" +page-actions: + options: + copy-page: false + view-as-markdown: false + ask-ai: false + chatgpt: false + claude: false + claude-code: false + cursor: false +``` + +The site's [MCP server](/learn/docs/ai-features/mcp-server) is configured under the same key, even though it controls an endpoint rather than a button: + +```yaml title="docs.yml" +page-actions: + options: + mcp: false +``` + +Setting `mcp: false` makes `/_mcp/server` return 404, omits its URL from [`llms.txt`](/learn/docs/ai-features/llms-txt) and agent prompts, and hides the **Connect to Claude Code** and **Connect to Cursor** buttons. This is the setting to use on [authenticated sites](/learn/docs/authentication/overview), where unauthenticated agents would otherwise discover an endpoint they can't reach. + +## The API Explorer + +An empty `environments` list disables the [API Explorer](/learn/docs/api-references/api-explorer). Set it on the `- api` entry to cover every endpoint in that API: + +```yaml title="docs.yml" {3,4} +navigation: + - api: API Reference + playground: + environments: [] +``` + +`playground` applies at the level it's declared on and can be overridden on a section or an individual endpoint in `layout`. For the full set of Explorer options, see [Setting API Explorer options](/learn/docs/api-references/customize-api-reference-layout#setting-api-explorer-options). + +## Individual pages + +Frontmatter turns features off for one page without changing the site-wide setting. + +| Frontmatter | Effect | +|-------------|--------| +| `hide-page-actions: true` | Hides every page action button | +| `hide-toc: true` | Hides the table of contents | +| `hide-nav-links: true` | Hides the previous and next navigation links | +| `hide-feedback: true` | Hides the on-page feedback widget | + +See [Page settings](/learn/docs/configuration/page-level-settings) for the full frontmatter reference. + +## Other site-wide settings + +| To turn off | Set | +|-------------|-----| +| The [search bar](/learn/docs/customization/search) | `settings.disable-search: true` | +| [Web analytics](/learn/dashboard/metrics/web-analytics) and every configured analytics provider | `settings.disable-analytics: true` | +| The 404 page, redirecting to the home page instead | `settings.hide-404-page: true` | +| [HTTP snippets](/learn/docs/api-references/http-snippets) in the API Reference | `settings.http-snippets: false` | +| [AI-generated examples](/learn/docs/ai-features/ai-examples) in the API Reference | `ai-examples.enabled: false` | +| The [directive prepended to pages served to agents](/learn/docs/ai-features/llms-txt) | `agents.page-directive: ""` | + +`settings.disable-explorer-proxy: true` is not an off switch for the Explorer. It keeps the Explorer running and sends requests directly to your API instead of through Fern's proxy, which requires CORS on your API. To turn the Explorer off, use an empty `playground.environments` list. + +Full details for each key are in [Site settings](/learn/docs/configuration/site-level-settings#settings-configuration). + +## Hiding pages, sections, and endpoints + +Removing content from the sidebar, search results, and `llms.txt` uses `hidden` and `noindex` rather than any of the settings covered here. See [Hiding content](/learn/docs/customization/hiding-content). diff --git a/fern/products/docs/pages/navigation/overview.mdx b/fern/products/docs/pages/navigation/overview.mdx index be920acb22..61e622984c 100644 --- a/fern/products/docs/pages/navigation/overview.mdx +++ b/fern/products/docs/pages/navigation/overview.mdx @@ -9,7 +9,7 @@ Fern documentation is configured at two levels: **site-level** settings in `docs `docs.yml` covers two concerns. Site-level settings determine how the site looks and behaves — branding, layout, navbar links, and analytics. Navigation determines what the site contains: which files become pages, how they group into sections, and what URL each one gets. Navigation is where most structural decisions land, so it spans several pages of its own. - + Colors, typography, logo, layout, navbar links, and analytics @@ -19,4 +19,7 @@ Fern documentation is configured at two levels: **site-level** settings in `docs Products, versions, tabs, sections, folders, and pages + + Turn off Ask Fern, page actions, the MCP server, and the API Explorer + diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx index ba8cc5d34a..9e4cafecf9 100644 --- a/fern/products/docs/pages/navigation/site-level-settings.mdx +++ b/fern/products/docs/pages/navigation/site-level-settings.mdx @@ -1199,7 +1199,7 @@ integrations: ## Ask Fern configuration -Specify [Ask Fern](/learn/ask-fern/getting-started/what-is-ask-fern) to control where it appears and what content it can access. +Specify [Ask Fern](/learn/ask-fern/getting-started/what-is-ask-fern) to control where it appears and what content it can access. These keys configure Ask Fern once it's enabled; enabling and [disabling Ask Fern](/learn/docs/configuration/disabling-features#ask-fern-and-the-ask-ai-button) happens in the Dashboard. ```yaml docs.yml ai-search: From 2a005fdd26a1cf4d39dee4dbfb35c9694588ce3f Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 6 Aug 2026 17:23:47 -0400 Subject: [PATCH 2/2] better seo headings and new sections --- fern/products/docs/docs.yml | 3 - fern/products/docs/pages/ai/ai-examples.mdx | 16 ++-- fern/products/docs/pages/ai/mcp-server.mdx | 2 +- .../pages/api-references/api-explorer.mdx | 6 +- .../docs/pages/ask-fern/what-is-ask-fern.mdx | 16 +++- .../pages/customization/hiding-content.mdx | 2 - .../docs/pages/customization/search.mdx | 11 +++ .../pages/customization/user-feedback.mdx | 13 ++- .../pages/navigation/disabling-features.mdx | 91 ------------------- .../docs/pages/navigation/overview.mdx | 5 +- .../pages/navigation/site-level-settings.mdx | 2 +- 11 files changed, 53 insertions(+), 114 deletions(-) delete mode 100644 fern/products/docs/pages/navigation/disabling-features.mdx diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml index ac53952d54..32fd453d3e 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -26,9 +26,6 @@ navigation: - page: Page settings path: ./pages/navigation/frontmatter.mdx slug: page-level-settings - - page: Disabling features - path: ./pages/navigation/disabling-features.mdx - slug: disabling-features - section: Navigation skip-slug: true contents: diff --git a/fern/products/docs/pages/ai/ai-examples.mdx b/fern/products/docs/pages/ai/ai-examples.mdx index 7b2b737d04..a1f878f98c 100644 --- a/fern/products/docs/pages/ai/ai-examples.mdx +++ b/fern/products/docs/pages/ai/ai-examples.mdx @@ -37,13 +37,6 @@ ai-examples: style: "Use names and emails that are inspired by plants." ``` -Or disable the feature entirely: - -```yaml docs.yml -ai-examples: - enabled: false -``` - AI-generated examples are written to `ai_examples_override.yml`. Edit this file to customize specific examples. To regenerate examples on each build instead, add the file to `.gitignore`: ```txt .gitignore @@ -53,3 +46,12 @@ AI-generated examples are written to `ai_examples_override.yml`. Edit this file To make AI-generated examples portable to non-Fern OpenAPI tools, use [`fern api enrich`](/learn/cli-api-reference/cli-reference/commands#fern-api-enrich) to merge them into native OpenAPI example fields. + +## Disable AI-generated examples + +To turn the feature off entirely, set `enabled` to `false`: + +```yaml docs.yml +ai-examples: + enabled: false +``` diff --git a/fern/products/docs/pages/ai/mcp-server.mdx b/fern/products/docs/pages/ai/mcp-server.mdx index 0892ec6d8d..2e63731293 100644 --- a/fern/products/docs/pages/ai/mcp-server.mdx +++ b/fern/products/docs/pages/ai/mcp-server.mdx @@ -86,7 +86,7 @@ For Cursor, VS Code, and other clients, add `FERN_TOKEN: ` to the `headers` JWTs expire. Re-run the token exchange when the token lapses. There is no automatic refresh mechanism in the MCP transport. -## Disable the server +## Disable the MCP server To turn the server off entirely, set `mcp` to `false` in your [`page-actions` configuration](/learn/docs/configuration/site-level-settings#page-actionsoptions.mcp): diff --git a/fern/products/docs/pages/api-references/api-explorer.mdx b/fern/products/docs/pages/api-references/api-explorer.mdx index acf6975fbd..c47c45f079 100644 --- a/fern/products/docs/pages/api-references/api-explorer.mdx +++ b/fern/products/docs/pages/api-references/api-explorer.mdx @@ -53,6 +53,8 @@ For APIs that support WebSocket connections, the API Explorer includes a **WebSo
-## Control API Explorer availability +## Disable the API Explorer -For OpenAPI specs, the API Explorer is enabled by default for all endpoints. You can disable it globally or per endpoint using the [`x-fern-explorer`](/learn/api-definitions/openapi/extensions/api-explorer-control) extension. This is commonly used to disable the Explorer for destructive operations, payment processing, or admin-only endpoints. +For OpenAPI specs, the API Explorer is enabled by default for all endpoints. To turn it off globally or per endpoint, use the [`x-fern-explorer`](/learn/api-definitions/openapi/extensions/api-explorer-control) extension. This is commonly used to disable the Explorer for destructive operations, payment processing, or admin-only endpoints. + +Setting [`disable-explorer-proxy`](/learn/docs/configuration/site-level-settings#settingsdisable-explorer-proxy) does not turn the Explorer off. It keeps the Explorer running and routes requests directly to your API instead of through Fern's proxy. 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 a4483d7ec5..6b4c2aa33c 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 @@ -21,7 +21,7 @@ Ask Fern is Fern's AI Search feature, powered by [Claude 4.6 Sonnet](https://www - Open the [Fern Dashboard](https://dashboard.buildwithfern.com/). Navigate to the **Settings** tab and click **Enable** on the Ask AI card. The same card [turns Ask Fern off](/learn/docs/configuration/disabling-features#ask-fern-and-the-ask-ai-button), which is separate from hiding the **Ask AI** page action button in `docs.yml`. + Open the [Fern Dashboard](https://dashboard.buildwithfern.com/). Navigate to the **Settings** tab and click **Enable** on the Ask AI card. Return to this card to [disable Ask Fern](#disable-ask-fern) later. Enabling Ask Fern triggers an automatic reindex of your content. This typically takes a few minutes, though sites with extensive custom components may take longer. Once this process is finished, the Ask Fern side panel will appear on your site. @@ -63,6 +63,20 @@ Ask Fern is Fern's AI Search feature, powered by [Claude 4.6 Sonnet](https://www +## 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. There is no `docs.yml` equivalent — the [`ai-search` key](/learn/docs/configuration/site-level-settings#ask-fern-configuration) configures Ask Fern once it's enabled, so setting `ai-search: {}` leaves it running with its default behavior. + +To keep Ask Fern and hide only its page action button, set [`ask-ai`](/learn/docs/configuration/site-level-settings#page-actionsoptions.ask-ai) to `false`: + +```yaml docs.yml +page-actions: + options: + ask-ai: false +``` + +Ask Fern stays reachable everywhere else it appears, including the search bar and the [standalone search widget](/learn/docs/ai-features/ask-fern/search-widget). + ## Features Ask Fern comes with built-in tools to help you understand how users interact with your documentation and ensure answers are accurate and trustworthy. diff --git a/fern/products/docs/pages/customization/hiding-content.mdx b/fern/products/docs/pages/customization/hiding-content.mdx index aadd71bd5a..d8b7fd370e 100644 --- a/fern/products/docs/pages/customization/hiding-content.mdx +++ b/fern/products/docs/pages/customization/hiding-content.mdx @@ -5,8 +5,6 @@ description: Control visibility of pages, sections, tabs, tab variants, versions Fern gives you two main tools for controlling content visibility: `hidden: true` in `docs.yml` removes content from your site's sidebar and search results, while `noindex: true` in page frontmatter excludes a page from search without affecting navigation. -Both control which of your content readers can reach. To turn off a built-in feature such as Ask Fern, a page action, or the API Explorer, see [Disabling features](/learn/docs/configuration/disabling-features). - ## Hiding a page ### Accessible only by direct URL diff --git a/fern/products/docs/pages/customization/search.mdx b/fern/products/docs/pages/customization/search.mdx index 6a094d1db6..c840e2ad6c 100644 --- a/fern/products/docs/pages/customization/search.mdx +++ b/fern/products/docs/pages/customization/search.mdx @@ -131,3 +131,14 @@ Contact the Fern team to get your specific application ID and index name. Creden ## Using an alternative search You can override Fern's search with your own solution using [custom JavaScript](/learn/docs/building-and-customizing-your-docs/custom-css-global-js#custom-javascript) and your Algolia credentials. + +## Disable search + +Set [`disable-search`](/learn/docs/configuration/site-level-settings#settingsdisable-search) to `true` to remove the search bar from your site: + +```yaml docs.yml +settings: + disable-search: true +``` + +Reach for this when you're replacing Fern's search with your own solution. To keep search working but exclude specific content from results, use [`hidden` and `noindex`](/learn/docs/customization/hiding-content) instead. diff --git a/fern/products/docs/pages/customization/user-feedback.mdx b/fern/products/docs/pages/customization/user-feedback.mdx index 4e0cba03bb..210ed63419 100644 --- a/fern/products/docs/pages/customization/user-feedback.mdx +++ b/fern/products/docs/pages/customization/user-feedback.mdx @@ -22,12 +22,21 @@ By default, every Markdown page of your docs contains a feedback component at th -You can also disable this feature for [individual pages](/learn/docs/configuration/page-level-settings#on-page-feedback) or [all pages](/learn/docs/configuration/site-level-settings#layouthide-feedback). - In [self-hosted](/learn/docs/self-hosted/overview) deployments, feedback events are logged as structured JSON to the container's stdout. See [On-page feedback](/learn/docs/self-hosted/set-up#on-page-feedback) for details. +### Disable on-page feedback + +Set [`hide-feedback`](/learn/docs/configuration/site-level-settings#layouthide-feedback) to `true` under `layout` in `docs.yml` to remove the feedback component from every page: + +```yaml docs.yml +layout: + hide-feedback: true +``` + +To remove it from a single page instead, set [`hide-feedback: true`](/learn/docs/configuration/page-level-settings#on-page-feedback) in that page's frontmatter. + ### Viewing feedback in the Dashboard You can view all on-page [feedback responses](/learn/dashboard/getting-started/overview) in the **Feedback** tab of the [Fern Dashboard](https://dashboard.buildwithfern.com/). The table shows feedback per page, including whether the page was helpful and the reason (if provided), plus channel, location, and date. You can filter by date range and export results to CSV. diff --git a/fern/products/docs/pages/navigation/disabling-features.mdx b/fern/products/docs/pages/navigation/disabling-features.mdx deleted file mode 100644 index 828a50c5b0..0000000000 --- a/fern/products/docs/pages/navigation/disabling-features.mdx +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Disabling features -subtitle: Turn off Ask Fern, page actions, the MCP server, the API Explorer, and other built-in features -description: Reference for turning off built-in Fern Docs features, including which controls live in docs.yml, page frontmatter, and the Fern Dashboard. ---- - -Most Fern Docs features are on by default. Where the off switch lives depends on the feature: `docs.yml` for site-wide behavior, page frontmatter for a single page, and the [Fern Dashboard](https://dashboard.buildwithfern.com/) for [Ask Fern](/learn/docs/ai-features/ask-fern/overview). - -## Ask Fern and the Ask AI button - -Ask Fern and the **Ask AI** page action button are separate controls. - -| To turn off | Set | -|-------------|-----| -| Ask Fern itself: AI search and the side panel | **Settings** > **Ask AI** card in the Dashboard | -| The **Ask AI** page action button | `page-actions.options.ask-ai: false` in `docs.yml` | - -The [`ai-search` key](/learn/docs/configuration/site-level-settings#ask-fern-configuration) configures Ask Fern once it's enabled, setting PII masking, additional datasources, and the system prompt. It has no enable or disable property, so `ai-search: {}` leaves Ask Fern running with its default behavior. - -Setting `ask-ai: false` hides the button from the page action bar and leaves Ask Fern reachable everywhere else it appears. - -## Page actions and the MCP server - -Every built-in page action is a boolean under [`page-actions.options`](/learn/docs/configuration/site-level-settings#built-in-actions). **Copy Page**, **View as Markdown**, **Ask AI**, **ChatGPT**, **Claude**, **Claude Code**, and **Cursor** are on by default. - -```yaml title="docs.yml" -page-actions: - options: - copy-page: false - view-as-markdown: false - ask-ai: false - chatgpt: false - claude: false - claude-code: false - cursor: false -``` - -The site's [MCP server](/learn/docs/ai-features/mcp-server) is configured under the same key, even though it controls an endpoint rather than a button: - -```yaml title="docs.yml" -page-actions: - options: - mcp: false -``` - -Setting `mcp: false` makes `/_mcp/server` return 404, omits its URL from [`llms.txt`](/learn/docs/ai-features/llms-txt) and agent prompts, and hides the **Connect to Claude Code** and **Connect to Cursor** buttons. This is the setting to use on [authenticated sites](/learn/docs/authentication/overview), where unauthenticated agents would otherwise discover an endpoint they can't reach. - -## The API Explorer - -An empty `environments` list disables the [API Explorer](/learn/docs/api-references/api-explorer). Set it on the `- api` entry to cover every endpoint in that API: - -```yaml title="docs.yml" {3,4} -navigation: - - api: API Reference - playground: - environments: [] -``` - -`playground` applies at the level it's declared on and can be overridden on a section or an individual endpoint in `layout`. For the full set of Explorer options, see [Setting API Explorer options](/learn/docs/api-references/customize-api-reference-layout#setting-api-explorer-options). - -## Individual pages - -Frontmatter turns features off for one page without changing the site-wide setting. - -| Frontmatter | Effect | -|-------------|--------| -| `hide-page-actions: true` | Hides every page action button | -| `hide-toc: true` | Hides the table of contents | -| `hide-nav-links: true` | Hides the previous and next navigation links | -| `hide-feedback: true` | Hides the on-page feedback widget | - -See [Page settings](/learn/docs/configuration/page-level-settings) for the full frontmatter reference. - -## Other site-wide settings - -| To turn off | Set | -|-------------|-----| -| The [search bar](/learn/docs/customization/search) | `settings.disable-search: true` | -| [Web analytics](/learn/dashboard/metrics/web-analytics) and every configured analytics provider | `settings.disable-analytics: true` | -| The 404 page, redirecting to the home page instead | `settings.hide-404-page: true` | -| [HTTP snippets](/learn/docs/api-references/http-snippets) in the API Reference | `settings.http-snippets: false` | -| [AI-generated examples](/learn/docs/ai-features/ai-examples) in the API Reference | `ai-examples.enabled: false` | -| The [directive prepended to pages served to agents](/learn/docs/ai-features/llms-txt) | `agents.page-directive: ""` | - -`settings.disable-explorer-proxy: true` is not an off switch for the Explorer. It keeps the Explorer running and sends requests directly to your API instead of through Fern's proxy, which requires CORS on your API. To turn the Explorer off, use an empty `playground.environments` list. - -Full details for each key are in [Site settings](/learn/docs/configuration/site-level-settings#settings-configuration). - -## Hiding pages, sections, and endpoints - -Removing content from the sidebar, search results, and `llms.txt` uses `hidden` and `noindex` rather than any of the settings covered here. See [Hiding content](/learn/docs/customization/hiding-content). diff --git a/fern/products/docs/pages/navigation/overview.mdx b/fern/products/docs/pages/navigation/overview.mdx index 61e622984c..be920acb22 100644 --- a/fern/products/docs/pages/navigation/overview.mdx +++ b/fern/products/docs/pages/navigation/overview.mdx @@ -9,7 +9,7 @@ Fern documentation is configured at two levels: **site-level** settings in `docs `docs.yml` covers two concerns. Site-level settings determine how the site looks and behaves — branding, layout, navbar links, and analytics. Navigation determines what the site contains: which files become pages, how they group into sections, and what URL each one gets. Navigation is where most structural decisions land, so it spans several pages of its own. - + Colors, typography, logo, layout, navbar links, and analytics @@ -19,7 +19,4 @@ Fern documentation is configured at two levels: **site-level** settings in `docs Products, versions, tabs, sections, folders, and pages - - Turn off Ask Fern, page actions, the MCP server, and the API Explorer - diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx index 9e4cafecf9..c3699b8ef7 100644 --- a/fern/products/docs/pages/navigation/site-level-settings.mdx +++ b/fern/products/docs/pages/navigation/site-level-settings.mdx @@ -1199,7 +1199,7 @@ integrations: ## Ask Fern configuration -Specify [Ask Fern](/learn/ask-fern/getting-started/what-is-ask-fern) to control where it appears and what content it can access. These keys configure Ask Fern once it's enabled; enabling and [disabling Ask Fern](/learn/docs/configuration/disabling-features#ask-fern-and-the-ask-ai-button) happens in the Dashboard. +Specify [Ask Fern](/learn/docs/ai-features/ask-fern/overview) to control where it appears and what content it can access. Use these keys to configure Ask Fern once it's enabled. To enable or disable Ask Fern itself, use the **Ask AI** card in the [Fern Dashboard](https://dashboard.buildwithfern.com/) — setting `ai-search: {}` leaves Ask Fern running with its default behavior rather than turning it off. ```yaml docs.yml ai-search: