From fb2a8cb8a918a558b225c41040be0861180e19ca Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Thu, 6 Aug 2026 15:10:53 +0000
Subject: [PATCH 1/7] Add capabilities pages for Docs, Dashboard, and Fern CLI
---
.../cli-api-reference/cli-api-reference.yml | 3 +
.../cli-api-reference/pages/capabilities.mdx | 255 ++++++++++++
fern/products/dashboard/dashboard.yml | 3 +
.../products/dashboard/pages/capabilities.mdx | 217 +++++++++++
fern/products/docs/docs.yml | 3 +
.../pages/getting-started/capabilities.mdx | 367 ++++++++++++++++++
6 files changed, 848 insertions(+)
create mode 100644 fern/products/cli-api-reference/pages/capabilities.mdx
create mode 100644 fern/products/dashboard/pages/capabilities.mdx
create mode 100644 fern/products/docs/pages/getting-started/capabilities.mdx
diff --git a/fern/products/cli-api-reference/cli-api-reference.yml b/fern/products/cli-api-reference/cli-api-reference.yml
index 331957b256..202f297fc3 100644
--- a/fern/products/cli-api-reference/cli-api-reference.yml
+++ b/fern/products/cli-api-reference/cli-api-reference.yml
@@ -4,6 +4,9 @@ navigation:
- page: Get started with Fern CLI
path: ./pages/cli-get-started.mdx
slug: overview
+ - page: Capabilities
+ path: ./pages/capabilities.mdx
+ slug: capabilities
- page: Global options
path: ./pages/global-options.mdx
slug: options
diff --git a/fern/products/cli-api-reference/pages/capabilities.mdx b/fern/products/cli-api-reference/pages/capabilities.mdx
new file mode 100644
index 0000000000..4cd4eddd57
--- /dev/null
+++ b/fern/products/cli-api-reference/pages/capabilities.mdx
@@ -0,0 +1,255 @@
+---
+title: Capabilities
+subtitle: Everything the Fern CLI can do, in one place.
+description: Fern CLI capabilities include project initialization, API definition validation, local previews, publishing docs, generating SDKs, link checking, and version management.
+layout: overview
+---
+
+
+
+
+
+ Start from an OpenAPI spec, or migrate an existing Mintlify or ReadMe site
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern check` catches API definition and configuration errors before you publish
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern docs md check` validates the Markdown and components in your pages
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern docs dev` serves your site locally with hot reloading
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Generate shareable preview URLs, then list and delete them when you're done
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern generate --docs` builds and publishes your documentation site
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern generate` builds and releases client libraries from your API definition
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern docs diff` compares a preview against production page by page
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern docs link check` finds broken links on a live documentation site
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Export, upload, and list the themes shared across your documentation sites
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern docs md generate` turns Python or C++ source into MDX reference pages
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ `fern export` produces an OpenAPI spec from any supported API definition
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Refresh your spec, merge example overrides, and write OpenAPI customizations
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Log in through GitHub, Google, Postman, or SSO, or set `FERN_TOKEN` in CI
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Upgrade or downgrade the CLI and generators, and enforce an organization-wide version policy
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Resolve and manage the patches Fern Replay keeps across SDK regenerations
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Flags that apply to every command, including `--log-level` and `--api`
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+
+
+
+The Fern CLI includes the following capabilities:
+
+- **Project initialization**: Start from an OpenAPI spec, or migrate an existing Mintlify or ReadMe site. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Definition validation**: `fern check` catches API definition and configuration errors before you publish. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **MDX validation**: `fern docs md check` validates the Markdown and components in your pages. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Local preview**: `fern docs dev` serves your site locally with hot reloading. [Learn more](/learn/docs/preview-publish/preview-changes)
+- **Preview deployments**: Generate shareable preview URLs, then list and delete them when you're done. [Learn more](/learn/docs/preview-publish/preview-changes)
+- **Publishing**: `fern generate --docs` builds and publishes your documentation site. [Learn more](/learn/docs/preview-publish/publishing-your-docs)
+- **SDK generation**: `fern generate` builds and releases client libraries from your API definition. [Learn more](/learn/sdks/overview/introduction)
+- **Visual diffs**: `fern docs diff` compares a preview against production page by page. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Link checking**: `fern docs link check` finds broken links on a live documentation site. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Theme management**: Export, upload, and list the themes shared across your documentation sites. [Learn more](/learn/docs/customization/global-themes)
+- **Library documentation**: `fern docs md generate` turns Python or C++ source into MDX reference pages. [Learn more](/learn/docs/api-references/library-reference)
+- **OpenAPI export**: `fern export` produces an OpenAPI spec from any supported API definition. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Spec updates and overrides**: Refresh your spec, merge example overrides, and write OpenAPI customizations. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Authentication**: Log in through GitHub, Google, Postman, or SSO, or set `FERN_TOKEN` in CI. [Learn more](/learn/dashboard/configuration/api-keys)
+- **Version management**: Upgrade or downgrade the CLI and generators, and enforce an organization-wide version policy. [Learn more](/learn/cli-api-reference/cli-reference/version-policy)
+- **Custom code preservation**: Resolve and manage the patches Fern Replay keeps across SDK regenerations. [Learn more](/learn/sdks/overview/custom-code)
+- **Global options**: Flags that apply to every command, including `--log-level` and `--api`. [Learn more](/learn/cli-api-reference/cli-reference/options)
+
diff --git a/fern/products/dashboard/dashboard.yml b/fern/products/dashboard/dashboard.yml
index 76ca8ca6e6..e1c712a782 100644
--- a/fern/products/dashboard/dashboard.yml
+++ b/fern/products/dashboard/dashboard.yml
@@ -3,6 +3,9 @@ navigation:
contents:
- page: Overview
path: ./pages/overview.mdx
+ - page: Capabilities
+ path: ./pages/capabilities.mdx
+ slug: capabilities
- section: Configuration
contents:
- page: Member permissions
diff --git a/fern/products/dashboard/pages/capabilities.mdx b/fern/products/dashboard/pages/capabilities.mdx
new file mode 100644
index 0000000000..811f18f835
--- /dev/null
+++ b/fern/products/dashboard/pages/capabilities.mdx
@@ -0,0 +1,217 @@
+---
+title: Capabilities
+subtitle: Everything you can manage from the Fern Dashboard.
+description: Fern Dashboard capabilities include custom domains, member permissions, SSO, API keys, analytics, Ask Fern conversations, feedback, and site management.
+layout: overview
+---
+
+
+
+
+
+ Point your domain at your docs site with automatic DNS record provisioning
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Assign Admin, Editor, or Viewer roles to control Dashboard and CLI access
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Let your team sign in to Fern with your identity provider
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Create and revoke the keys the CLI uses to authenticate in CI/CD
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Connect a repository so Fern can open pull requests and read your docs
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Restrict access to your docs site with a shared password
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Export your complete documentation site as a PDF
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Track how developers, bots, and LLM crawlers interact with your docs
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ See what readers search for, and what they fail to find
+
+
+
+
+ Review AI chat history to find gaps in your documentation
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Read on-page reactions and edit suggestions from your readers
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Scan your published site for broken internal and external links
+
+
+
+
+ Start and manage visual editing sessions for your team
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Check deployment status, domains, CLI version, and connected repositories
+
+
+
+
+ Purge Ask Fern end-user query logs on a schedule instead of keeping them indefinitely
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Take a site offline temporarily without deleting it
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+
+
+
+The Fern Dashboard includes the following capabilities:
+
+- **Custom domains**: Point your domain at your docs site with automatic DNS record provisioning. [Learn more](/learn/dashboard/configuration/custom-domains)
+- **Member permissions**: Assign Admin, Editor, or Viewer roles to control Dashboard and CLI access. [Learn more](/learn/dashboard/configuration/permissions)
+- **Single sign-on**: Let your team sign in to Fern with your identity provider. [Learn more](/learn/dashboard/configuration/sso)
+- **API keys**: Create and revoke the keys the CLI uses to authenticate in CI/CD. [Learn more](/learn/dashboard/configuration/api-keys)
+- **GitHub integration**: Connect a repository so Fern can open pull requests and read your docs. [Learn more](/learn/dashboard/configuration/github-repo)
+- **Password protection**: Restrict access to your docs site with a shared password. [Learn more](/learn/dashboard/configuration/password-protection)
+- **PDF export**: Export your complete documentation site as a PDF. [Learn more](/learn/dashboard/configuration/pdf-export)
+- **Web analytics**: Track how developers, bots, and LLM crawlers interact with your docs. [Learn more](/learn/dashboard/metrics/web-analytics)
+- **Search analytics**: See what readers search for, and what they fail to find.
+- **Ask Fern conversations**: Review AI chat history to find gaps in your documentation. [Learn more](/learn/docs/ai-features/ask-fern/overview)
+- **User feedback**: Read on-page reactions and edit suggestions from your readers. [Learn more](/learn/docs/user-feedback)
+- **Broken link scans**: Scan your published site for broken internal and external links.
+- **Fern Editor sessions**: Start and manage visual editing sessions for your team. [Learn more](/learn/docs/writing-content/fern-editor)
+- **Site information**: Check deployment status, domains, CLI version, and connected repositories.
+- **Query log retention**: Purge Ask Fern end-user query logs on a schedule instead of keeping them indefinitely. [Learn more](/learn/docs/ai-features/ask-fern/overview#features)
+- **Unpublishing**: Take a site offline temporarily without deleting it. [Learn more](/learn/docs/preview-publish/publishing-your-docs#unpublishing-your-docs)
+
diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml
index 32fd453d3e..27f3710be1 100644
--- a/fern/products/docs/docs.yml
+++ b/fern/products/docs/docs.yml
@@ -3,6 +3,9 @@ navigation:
contents:
- page: Overview
path: ./pages/getting-started/overview.mdx
+ - page: Capabilities
+ path: ./pages/getting-started/capabilities.mdx
+ slug: capabilities
- page: How it works
path: ./pages/getting-started/how-it-works.mdx
- page: Quickstart
diff --git a/fern/products/docs/pages/getting-started/capabilities.mdx b/fern/products/docs/pages/getting-started/capabilities.mdx
new file mode 100644
index 0000000000..2f3d6ee8be
--- /dev/null
+++ b/fern/products/docs/pages/getting-started/capabilities.mdx
@@ -0,0 +1,367 @@
+---
+title: Capabilities
+subtitle: Everything Fern Docs can do, in one place.
+description: Fern Docs capabilities include a component library, generated API references, Ask Fern, MCP, RBAC, localization, self-hosting, analytics, and more.
+layout: overview
+---
+
+
+
+
+
+ Accordions, tabs, callouts, code blocks, and dozens of other prebuilt components
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Single-source content once and reuse it across pages
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Visual editing for teammates without Markdown or Git access
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Sections, folders, tabs, versions, and products in one config file
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Dated release entries with tag filtering and an RSS feed
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Generate references from OpenAPI, AsyncAPI, gRPC, OpenRPC, and GraphQL
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Send real requests to your API from the docs, with prefilled auth
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ AI search that answers reader questions in your docs and in Slack
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Connect Claude Code, Cursor, and other AI clients to your documentation
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Serve every page as Markdown, plus `llms.txt`, for AI agents and tooling
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Teach coding agents to author your docs, and host skills for your readers
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ A Slack-based technical writing agent that ships updates as pull requests
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Algolia-backed search with configurable filtering and ranking
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Style and extend your site with custom code and components
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Define branding in one repository and apply it across child sites
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Protect your docs with a password, SSO, JWT, or OAuth
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Show pages, sections, and endpoints based on each reader's role
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Ship documentation in multiple languages from a single source
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Publish one site from multiple repositories owned by independent teams
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ A local dev server and shareable preview links for every change
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Serve your docs from your own subdomain or subpath
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Deploy on your own infrastructure to meet security and compliance requirements
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Forward events to PostHog, Google, Segment, Mixpanel, Fullstory, and Intercom
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ Control metadata, slugs, redirects, and `robots.txt`
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+ WCAG 2.1 AA color contrast, keyboard navigation, and screen reader support
+
+
+ Learn more
+
+
+
+
+
+
+
+
+
+
+
+
+Fern Docs includes the following capabilities:
+
+- **Component library**: Accordions, tabs, callouts, code blocks, and dozens of other prebuilt components. [Learn more](/learn/docs/writing-content/components/overview)
+- **Reusable snippets**: Single-source content once and reuse it across pages. [Learn more](/learn/docs/writing-content/reusable-snippets)
+- **Fern Editor**: Visual editing for teammates without Markdown or Git access. [Learn more](/learn/docs/writing-content/fern-editor)
+- **Navigation**: Sections, folders, tabs, versions, and products in one config file. [Learn more](/learn/docs/configuration/navigation-overview)
+- **Changelog pages**: Dated release entries with tag filtering and an RSS feed. [Learn more](/learn/docs/configuration/changelogs)
+- **API References**: Generate references from OpenAPI, AsyncAPI, gRPC, OpenRPC, and GraphQL. [Learn more](/learn/docs/api-references/overview)
+- **API Explorer**: Send real requests to your API from the docs, with prefilled auth. [Learn more](/learn/docs/api-references/api-explorer)
+- **Ask Fern**: AI search that answers reader questions in your docs and in Slack. [Learn more](/learn/docs/ai-features/ask-fern/overview)
+- **MCP server**: Connect Claude Code, Cursor, and other AI clients to your documentation. [Learn more](/learn/docs/ai-features/mcp-server)
+- **Markdown access**: Serve every page as Markdown, plus `llms.txt`, for AI agents and tooling. [Learn more](/learn/docs/ai-features/markdown)
+- **Agent skills**: Teach coding agents to author your docs, and host skills for your readers. [Learn more](/learn/docs/ai-features/agent-skills)
+- **Fern Writer**: A Slack-based technical writing agent that ships updates as pull requests. [Learn more](/learn/docs/ai-features/fern-writer)
+- **Search**: Algolia-backed search with configurable filtering and ranking. [Learn more](/learn/docs/customization/search)
+- **Custom CSS, JS, and React**: Style and extend your site with custom code and components. [Learn more](/learn/docs/customization/custom-css-js)
+- **Global themes**: Define branding in one repository and apply it across child sites. [Learn more](/learn/docs/customization/global-themes)
+- **Authentication**: Protect your docs with a password, SSO, JWT, or OAuth. [Learn more](/learn/docs/authentication/overview)
+- **Role-based access control**: Show pages, sections, and endpoints based on each reader's role. [Learn more](/learn/docs/authentication/features/rbac)
+- **Localization**: Ship documentation in multiple languages from a single source. [Learn more](/learn/docs/localization/overview)
+- **Multi-source docs**: Publish one site from multiple repositories owned by independent teams. [Learn more](/learn/docs/preview-publish/multi-source-docs)
+- **Previews**: A local dev server and shareable preview links for every change. [Learn more](/learn/docs/preview-publish/preview-changes)
+- **Custom domains**: Serve your docs from your own subdomain or subpath. [Learn more](/learn/docs/preview-publish/setting-up-your-domain)
+- **Self-hosting**: Deploy on your own infrastructure to meet security and compliance requirements. [Learn more](/learn/docs/self-hosted/overview)
+- **Analytics and integrations**: Forward events to PostHog, Google, Segment, Mixpanel, Fullstory, and Intercom. [Learn more](/learn/docs/integrations/overview)
+- **SEO and GEO**: Control metadata, slugs, redirects, and `robots.txt`. [Learn more](/learn/docs/seo/overview)
+- **Accessibility**: WCAG 2.1 AA color contrast, keyboard navigation, and screen reader support. [Learn more](/learn/docs/accessibility/overview)
+
From 4bf3386078b0e31b5288c755727b9ae46ff0ab8b Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Thu, 6 Aug 2026 15:12:46 +0000
Subject: [PATCH 2/7] Spell out WCAG on the Docs capabilities page
---
fern/products/docs/pages/getting-started/capabilities.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/fern/products/docs/pages/getting-started/capabilities.mdx b/fern/products/docs/pages/getting-started/capabilities.mdx
index 2f3d6ee8be..bcd71589f9 100644
--- a/fern/products/docs/pages/getting-started/capabilities.mdx
+++ b/fern/products/docs/pages/getting-started/capabilities.mdx
@@ -321,7 +321,7 @@ layout: overview
- WCAG 2.1 AA color contrast, keyboard navigation, and screen reader support
+ Web Content Accessibility Guidelines (WCAG) 2.1 AA color contrast, keyboard navigation, and screen reader support
Learn more
@@ -363,5 +363,5 @@ Fern Docs includes the following capabilities:
- **Self-hosting**: Deploy on your own infrastructure to meet security and compliance requirements. [Learn more](/learn/docs/self-hosted/overview)
- **Analytics and integrations**: Forward events to PostHog, Google, Segment, Mixpanel, Fullstory, and Intercom. [Learn more](/learn/docs/integrations/overview)
- **SEO and GEO**: Control metadata, slugs, redirects, and `robots.txt`. [Learn more](/learn/docs/seo/overview)
-- **Accessibility**: WCAG 2.1 AA color contrast, keyboard navigation, and screen reader support. [Learn more](/learn/docs/accessibility/overview)
+- **Accessibility**: Web Content Accessibility Guidelines (WCAG) 2.1 AA color contrast, keyboard navigation, and screen reader support. [Learn more](/learn/docs/accessibility/overview)
From e1912b2941cf8170b00136ce6d8902f3bbc2580a Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Thu, 6 Aug 2026 15:27:32 +0000
Subject: [PATCH 3/7] Shorten CLI cards, drop Dashboard capabilities page,
dedupe Docs overview
---
.../cli-api-reference/pages/capabilities.mdx | 70 +++---
fern/products/dashboard/dashboard.yml | 3 -
.../products/dashboard/pages/capabilities.mdx | 217 ------------------
fern/products/dashboard/pages/overview.mdx | 12 +-
.../docs/pages/getting-started/overview.mdx | 74 +-----
5 files changed, 55 insertions(+), 321 deletions(-)
delete mode 100644 fern/products/dashboard/pages/capabilities.mdx
diff --git a/fern/products/cli-api-reference/pages/capabilities.mdx b/fern/products/cli-api-reference/pages/capabilities.mdx
index 4cd4eddd57..00e051f1f1 100644
--- a/fern/products/cli-api-reference/pages/capabilities.mdx
+++ b/fern/products/cli-api-reference/pages/capabilities.mdx
@@ -9,7 +9,7 @@ layout: overview
- Start from an OpenAPI spec, or migrate an existing Mintlify or ReadMe site
+ Start from an OpenAPI spec, or migrate a Mintlify or ReadMe site
Learn more
@@ -22,7 +22,7 @@ layout: overview
- `fern check` catches API definition and configuration errors before you publish
+ Catch API definition and configuration errors before publishing
Learn more
@@ -34,8 +34,8 @@ layout: overview
-
- `fern docs md check` validates the Markdown and components in your pages
+
+ Check the Markdown and components in your pages
Learn more
@@ -48,7 +48,7 @@ layout: overview
- `fern docs dev` serves your site locally with hot reloading
+ Serve your docs locally with hot reloading
Learn more
@@ -61,7 +61,7 @@ layout: overview
- Generate shareable preview URLs, then list and delete them when you're done
+ Create shareable preview URLs, then list and delete them
Learn more
@@ -74,7 +74,7 @@ layout: overview
- `fern generate --docs` builds and publishes your documentation site
+ Build and publish your documentation site
Learn more
@@ -87,7 +87,7 @@ layout: overview
- `fern generate` builds and releases client libraries from your API definition
+ Build and release client libraries from your API definition
Learn more
@@ -100,7 +100,7 @@ layout: overview
- `fern docs diff` compares a preview against production page by page
+ Compare a preview against production page by page
Learn more
@@ -113,7 +113,7 @@ layout: overview
- `fern docs link check` finds broken links on a live documentation site
+ Find broken links on a live documentation site
Learn more
@@ -126,7 +126,7 @@ layout: overview
- Export, upload, and list the themes shared across your documentation sites
+ Export, upload, and list the themes shared across your sites
Learn more
@@ -139,7 +139,7 @@ layout: overview
- `fern docs md generate` turns Python or C++ source into MDX reference pages
+ Turn Python or C++ source into MDX reference pages
Learn more
@@ -152,7 +152,7 @@ layout: overview
- `fern export` produces an OpenAPI spec from any supported API definition
+ Produce an OpenAPI spec from any supported API definition
Learn more
@@ -165,7 +165,7 @@ layout: overview
- Refresh your spec, merge example overrides, and write OpenAPI customizations
+ Refresh your spec, merge examples, and write OpenAPI customizations
Learn more
@@ -178,7 +178,7 @@ layout: overview
- Log in through GitHub, Google, Postman, or SSO, or set `FERN_TOKEN` in CI
+ Log in with GitHub, Google, Postman, or SSO, or use a token in CI
Learn more
@@ -191,7 +191,7 @@ layout: overview
- Upgrade or downgrade the CLI and generators, and enforce an organization-wide version policy
+ Upgrade or downgrade the CLI and generators, and enforce a version policy
Learn more
@@ -204,7 +204,7 @@ layout: overview
- Resolve and manage the patches Fern Replay keeps across SDK regenerations
+ Manage the patches Fern Replay keeps across SDK regenerations
Learn more
@@ -217,7 +217,7 @@ layout: overview
- Flags that apply to every command, including `--log-level` and `--api`
+ Flags that apply to every command
Learn more
@@ -235,21 +235,21 @@ layout: overview
The Fern CLI includes the following capabilities:
-- **Project initialization**: Start from an OpenAPI spec, or migrate an existing Mintlify or ReadMe site. [Learn more](/learn/cli-api-reference/cli-reference/commands)
-- **Definition validation**: `fern check` catches API definition and configuration errors before you publish. [Learn more](/learn/cli-api-reference/cli-reference/commands)
-- **MDX validation**: `fern docs md check` validates the Markdown and components in your pages. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
-- **Local preview**: `fern docs dev` serves your site locally with hot reloading. [Learn more](/learn/docs/preview-publish/preview-changes)
-- **Preview deployments**: Generate shareable preview URLs, then list and delete them when you're done. [Learn more](/learn/docs/preview-publish/preview-changes)
-- **Publishing**: `fern generate --docs` builds and publishes your documentation site. [Learn more](/learn/docs/preview-publish/publishing-your-docs)
-- **SDK generation**: `fern generate` builds and releases client libraries from your API definition. [Learn more](/learn/sdks/overview/introduction)
-- **Visual diffs**: `fern docs diff` compares a preview against production page by page. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
-- **Link checking**: `fern docs link check` finds broken links on a live documentation site. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
-- **Theme management**: Export, upload, and list the themes shared across your documentation sites. [Learn more](/learn/docs/customization/global-themes)
-- **Library documentation**: `fern docs md generate` turns Python or C++ source into MDX reference pages. [Learn more](/learn/docs/api-references/library-reference)
-- **OpenAPI export**: `fern export` produces an OpenAPI spec from any supported API definition. [Learn more](/learn/cli-api-reference/cli-reference/commands)
-- **Spec updates and overrides**: Refresh your spec, merge example overrides, and write OpenAPI customizations. [Learn more](/learn/cli-api-reference/cli-reference/commands)
-- **Authentication**: Log in through GitHub, Google, Postman, or SSO, or set `FERN_TOKEN` in CI. [Learn more](/learn/dashboard/configuration/api-keys)
-- **Version management**: Upgrade or downgrade the CLI and generators, and enforce an organization-wide version policy. [Learn more](/learn/cli-api-reference/cli-reference/version-policy)
-- **Custom code preservation**: Resolve and manage the patches Fern Replay keeps across SDK regenerations. [Learn more](/learn/sdks/overview/custom-code)
-- **Global options**: Flags that apply to every command, including `--log-level` and `--api`. [Learn more](/learn/cli-api-reference/cli-reference/options)
+- **Project initialization**: Start from an OpenAPI spec, or migrate a Mintlify or ReadMe site. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Definition validation**: Catch API definition and configuration errors before publishing. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Markdown validation**: Check the Markdown and components in your pages. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Local preview**: Serve your docs locally with hot reloading. [Learn more](/learn/docs/preview-publish/preview-changes)
+- **Preview deployments**: Create shareable preview URLs, then list and delete them. [Learn more](/learn/docs/preview-publish/preview-changes)
+- **Publishing**: Build and publish your documentation site. [Learn more](/learn/docs/preview-publish/publishing-your-docs)
+- **SDK generation**: Build and release client libraries from your API definition. [Learn more](/learn/sdks/overview/introduction)
+- **Visual diffs**: Compare a preview against production page by page. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Link checking**: Find broken links on a live documentation site. [Learn more](/learn/cli-api-reference/cli-reference/commands#documentation-commands)
+- **Theme management**: Export, upload, and list the themes shared across your sites. [Learn more](/learn/docs/customization/global-themes)
+- **Library documentation**: Turn Python or C++ source into MDX reference pages. [Learn more](/learn/docs/api-references/library-reference)
+- **OpenAPI export**: Produce an OpenAPI spec from any supported API definition. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Spec updates and overrides**: Refresh your spec, merge examples, and write OpenAPI customizations. [Learn more](/learn/cli-api-reference/cli-reference/commands)
+- **Authentication**: Log in with GitHub, Google, Postman, or SSO, or use a token in CI. [Learn more](/learn/dashboard/configuration/api-keys)
+- **Version management**: Upgrade or downgrade the CLI and generators, and enforce a version policy. [Learn more](/learn/cli-api-reference/cli-reference/version-policy)
+- **Custom code preservation**: Manage the patches Fern Replay keeps across SDK regenerations. [Learn more](/learn/sdks/overview/custom-code)
+- **Global options**: Flags that apply to every command. [Learn more](/learn/cli-api-reference/cli-reference/options)
diff --git a/fern/products/dashboard/dashboard.yml b/fern/products/dashboard/dashboard.yml
index e1c712a782..76ca8ca6e6 100644
--- a/fern/products/dashboard/dashboard.yml
+++ b/fern/products/dashboard/dashboard.yml
@@ -3,9 +3,6 @@ navigation:
contents:
- page: Overview
path: ./pages/overview.mdx
- - page: Capabilities
- path: ./pages/capabilities.mdx
- slug: capabilities
- section: Configuration
contents:
- page: Member permissions
diff --git a/fern/products/dashboard/pages/capabilities.mdx b/fern/products/dashboard/pages/capabilities.mdx
deleted file mode 100644
index 811f18f835..0000000000
--- a/fern/products/dashboard/pages/capabilities.mdx
+++ /dev/null
@@ -1,217 +0,0 @@
----
-title: Capabilities
-subtitle: Everything you can manage from the Fern Dashboard.
-description: Fern Dashboard capabilities include custom domains, member permissions, SSO, API keys, analytics, Ask Fern conversations, feedback, and site management.
-layout: overview
----
-
-
-
-
-
- Point your domain at your docs site with automatic DNS record provisioning
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Assign Admin, Editor, or Viewer roles to control Dashboard and CLI access
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Let your team sign in to Fern with your identity provider
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Create and revoke the keys the CLI uses to authenticate in CI/CD
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Connect a repository so Fern can open pull requests and read your docs
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Restrict access to your docs site with a shared password
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Export your complete documentation site as a PDF
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Track how developers, bots, and LLM crawlers interact with your docs
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- See what readers search for, and what they fail to find
-
-
-
-
- Review AI chat history to find gaps in your documentation
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Read on-page reactions and edit suggestions from your readers
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Scan your published site for broken internal and external links
-
-
-
-
- Start and manage visual editing sessions for your team
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Check deployment status, domains, CLI version, and connected repositories
-
-
-
-
- Purge Ask Fern end-user query logs on a schedule instead of keeping them indefinitely
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Take a site offline temporarily without deleting it
-
-
- Learn more
-
-
-
-
-
-
-
-
-
-
-
-
-The Fern Dashboard includes the following capabilities:
-
-- **Custom domains**: Point your domain at your docs site with automatic DNS record provisioning. [Learn more](/learn/dashboard/configuration/custom-domains)
-- **Member permissions**: Assign Admin, Editor, or Viewer roles to control Dashboard and CLI access. [Learn more](/learn/dashboard/configuration/permissions)
-- **Single sign-on**: Let your team sign in to Fern with your identity provider. [Learn more](/learn/dashboard/configuration/sso)
-- **API keys**: Create and revoke the keys the CLI uses to authenticate in CI/CD. [Learn more](/learn/dashboard/configuration/api-keys)
-- **GitHub integration**: Connect a repository so Fern can open pull requests and read your docs. [Learn more](/learn/dashboard/configuration/github-repo)
-- **Password protection**: Restrict access to your docs site with a shared password. [Learn more](/learn/dashboard/configuration/password-protection)
-- **PDF export**: Export your complete documentation site as a PDF. [Learn more](/learn/dashboard/configuration/pdf-export)
-- **Web analytics**: Track how developers, bots, and LLM crawlers interact with your docs. [Learn more](/learn/dashboard/metrics/web-analytics)
-- **Search analytics**: See what readers search for, and what they fail to find.
-- **Ask Fern conversations**: Review AI chat history to find gaps in your documentation. [Learn more](/learn/docs/ai-features/ask-fern/overview)
-- **User feedback**: Read on-page reactions and edit suggestions from your readers. [Learn more](/learn/docs/user-feedback)
-- **Broken link scans**: Scan your published site for broken internal and external links.
-- **Fern Editor sessions**: Start and manage visual editing sessions for your team. [Learn more](/learn/docs/writing-content/fern-editor)
-- **Site information**: Check deployment status, domains, CLI version, and connected repositories.
-- **Query log retention**: Purge Ask Fern end-user query logs on a schedule instead of keeping them indefinitely. [Learn more](/learn/docs/ai-features/ask-fern/overview#features)
-- **Unpublishing**: Take a site offline temporarily without deleting it. [Learn more](/learn/docs/preview-publish/publishing-your-docs#unpublishing-your-docs)
-
diff --git a/fern/products/dashboard/pages/overview.mdx b/fern/products/dashboard/pages/overview.mdx
index 4a2a0c834f..7f2dfd5ce1 100644
--- a/fern/products/dashboard/pages/overview.mdx
+++ b/fern/products/dashboard/pages/overview.mdx
@@ -48,6 +48,13 @@ Visit your team's [Dashboard](https://dashboard.buildwithfern.com/) and complete
>
Create and manage API keys for CLI authentication in CI/CD.
+
+ Let your team sign in to Fern through your identity provider.
+
Review AI chat conversation history.
@@ -196,6 +203,7 @@ Visit your team's [Dashboard](https://dashboard.buildwithfern.com/) and complete
- [Set up custom domain](/learn/dashboard/configuration/custom-domains): Configure your custom domain with automatic DNS record provisioning.
- [Member permissions](/learn/dashboard/configuration/permissions): Assign Admin, Editor, or Viewer roles to manage Dashboard and CLI access.
- [API keys](/learn/dashboard/configuration/api-keys): Create and manage API keys for CLI authentication in CI/CD.
+- [Set up SSO](/learn/dashboard/configuration/sso): Let your team sign in to Fern through your identity provider.
- [Integrate GitHub](/learn/dashboard/configuration/github-repo): Connect your GitHub repository to your project.
- [Enable Ask Fern](/learn/docs/ai-features/ask-fern/overview): Set up AI-powered chat for your documentation.
- [Multi-source settings](/learn/dashboard/configuration/custom-domains#multi-source-settings): Configure default path and search scope for domains shared across multiple repositories.
@@ -208,7 +216,7 @@ Monitor and analyze how developers interact with your documentation:
- **Search analytics**: Monitor search queries to understand what developers are looking for in your docs.
- **Broken links**: Scan your published docs for broken internal and external links.
- [Feedback](/learn/docs/user-feedback): View and respond to on-page feedback.
-- [Ask Fern conversations](/learn/ask-fern/getting-started/what-is-ask-fern): Review AI chat conversation history.
+- [Ask Fern conversations](/learn/docs/ai-features/ask-fern/overview): Review AI chat conversation history.
## Site management
diff --git a/fern/products/docs/pages/getting-started/overview.mdx b/fern/products/docs/pages/getting-started/overview.mdx
index fa32d48a66..b9592ba5f4 100644
--- a/fern/products/docs/pages/getting-started/overview.mdx
+++ b/fern/products/docs/pages/getting-started/overview.mdx
@@ -52,55 +52,21 @@ subtitle: Build beautiful, interactive documentation websites with Fern Docs. Cr
Features
-
Build your own components, enable Ask Fern, generate API references, and easily update your docs.
+
Components, generated API references, AI features, authentication, localization, self-hosting, and more.
+
+ ## Quickstart
+
+
-## Get started
-
-Build a docs site by importing your existing styling and specs.
-
-- [Quickstart](/docs/getting-started/quickstart): Set up a documentation site in under 5 minutes.
-- [Configure with ease](/docs/configuration/site-level-settings): Use one simple file to generate documentation that fits your brand.
+[Quickstart](/learn/docs/getting-started/quickstart): Set up a docs site in under 5 minutes.
+
-## Features
+
+
+ How your Markdown and API specs become a published site
+
+
+ The files and folders in a Fern Docs project
+
+
-Components, generated API references, AI features, authentication, localization, self-hosting, and more.
+## Capabilities
-- [All capabilities](/docs/getting-started/capabilities): Everything Fern Docs can do, on one page.
-- [AI features](/docs/ai-features/overview): Ask Fern, MCP, agent-ready Markdown, and AI-generated examples.
-
+
+
+ Accordions, tabs, callouts, code blocks, and dozens more
+
+
+ Write content once and reuse it across pages
+
+
+ Visual editing for teammates without Git access
+
+
+ Sections, tabs, versions, and products in one file
+
+
+ Dated release entries with tag filtering and RSS
+
+
+ Generate references from OpenAPI, AsyncAPI, gRPC, and more
+
+
+ Send real requests with prefilled auth
+
+
+ AI search that answers reader questions
+
+
+ Connect Claude Code, Cursor, and other AI clients
+
+
+ Serve every page as Markdown, plus `llms.txt`
+
+
+ Teach coding agents to author your docs
+
+
+ A Slack-based writing agent that ships pull requests
+
+
+ Algolia-backed search with custom filtering and ranking
+
+
+ Style and extend your site with custom code
+
+
+ Define branding once and apply it across child sites
+
+
+ Protect your docs with a password, SSO, JWT, or OAuth
+
+
+ Show content based on each reader's role
+
+
+ Ship docs in multiple languages from a single source
+
+
+ Publish one site from multiple repositories
+
+
+ A local dev server and shareable preview links
+
+
+ Serve your docs from your own subdomain or subpath
+
+
+ Deploy on your own infrastructure
+
+
+ Forward events to PostHog, Segment, Mixpanel, and more
+
+
+ Control metadata, slugs, redirects, and `robots.txt`
+
+
+ WCAG 2.1 AA contrast, keyboard navigation, and screen readers
+
+
From d56f43fc08171fb87e82d6ac73680f1b979978e9 Mon Sep 17 00:00:00 2001
From: "fern-api[bot]" <115122769+fern-api[bot]@users.noreply.github.com>
Date: Thu, 6 Aug 2026 17:06:26 +0000
Subject: [PATCH 6/7] Remove the CLI generator capabilities page
---
fern/products/cli-generator/capabilities.mdx | 273 ------------------
fern/products/cli-generator/cli-generator.yml | 3 -
fern/products/cli-generator/overview.mdx | 4 +-
3 files changed, 2 insertions(+), 278 deletions(-)
delete mode 100644 fern/products/cli-generator/capabilities.mdx
diff --git a/fern/products/cli-generator/capabilities.mdx b/fern/products/cli-generator/capabilities.mdx
deleted file mode 100644
index 234d786c28..0000000000
--- a/fern/products/cli-generator/capabilities.mdx
+++ /dev/null
@@ -1,273 +0,0 @@
----
-title: Capabilities
-subtitle: Everything a Fern-generated CLI ships with.
-description: Fern CLI generator capabilities include a single static binary, agent-ready introspection, output formatting, retries, pagination, auth, publishing, and self-hosted generation.
-availability: beta
-layout: overview
----
-
-
-The CLI generator is in early access. [Reach out](https://buildwithfern.com/book-demo?type=cli) to get started.
-
-
-
-
-
- One statically linked Rust binary, with no language runtime or dependencies
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Build a CLI from an OpenAPI spec or a GraphQL introspection schema
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Structured JSON help and schema output that AI agents can read
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Return responses as JSON, a table, YAML, or CSV
-
-
- Learn more
-
-
-
-
-
-
-
-
-
- Preview the request a command would send without sending it
-
-
+
+ 
+ 
- 
+ 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
-