fix short meta descriptions for seo

devalog · devalog · commit e54ec6cead2a · 2025-12-23T13:07:07.000-05:00
diff --git a/fern/products/api-def/asyncapi-pages/extensions/ignore.mdx b/fern/products/api-def/asyncapi-pages/extensions/ignore.mdx
@@ -1,6 +1,6 @@
 ---
 title: Ignoring operations, channels, or schemas
-description: Skip reading specific AsyncAPI elements using `x-fern-ignore` extension
+description: Learn how to use x-fern-ignore to exclude specific operations, channels, or schemas from AsyncAPI SDK generation.
 ---
 
 Use `x-fern-ignore` to exclude specific operations, channels, or schemas from SDK generation:
diff --git a/fern/products/api-def/openapi-pages/extensions/audiences.mdx b/fern/products/api-def/openapi-pages/extensions/audiences.mdx
@@ -1,6 +1,6 @@
 ---
 title: Use audiences to filter your API
-subtitle: Use `x-fern-audiences` to filter to relevant endpoints, schemas and properties
+subtitle: Learn how to use x-fern-audiences to filter OpenAPI endpoints, schemas, and properties for different API consumers like public and beta users.
 ---
 
 <Markdown src="/snippets/pro-plan.mdx"/>
diff --git a/fern/products/api-def/openrpc-pages/automation.mdx b/fern/products/api-def/openrpc-pages/automation.mdx
@@ -1,6 +1,6 @@
 ---
 title: Sync your OpenRPC specification
-subtitle: Automatically sync your OpenRPC spec changes to keep SDKs and docs up to date
+subtitle: Automate OpenRPC spec syncing to keep SDKs and documentation current. Set up GitHub Actions, webhooks, and CI/CD integrations with Fern.
 ---
 
 Keeping your OpenRPC specifications in sync with your codebase is crucial for maintaining accurate SDKs and documentation. Fern provides several automation options to streamline this process.
diff --git a/fern/products/ask-fern/pages/getting-started/how-it-works.mdx b/fern/products/ask-fern/pages/getting-started/how-it-works.mdx
@@ -1,6 +1,6 @@
 ---
 title: How Ask Fern works
-description: Learn how Ask Fern's RAG system transforms your documentation into an intelligent, searchable knowledge base with automatic indexing, semantic search, and AI-powered responses.
+description: Learn how Ask Fern works with RAG technology to index documentation, process queries, and generate accurate answers with citations.
 ---
 
 Ask Fern is a **Retrieval Augmented Generation (RAG)** system that appears as a side panel on your documentation site, transforming your documentation into an intelligent, searchable knowledge base.
diff --git a/fern/products/cli-api-reference/pages/cli-get-started.mdx b/fern/products/cli-api-reference/pages/cli-get-started.mdx
@@ -1,7 +1,7 @@
 ---
-title: 'Overview'
+title: Overview
 subtitle: Manage and configure your Fern projects, all from the command line.
-description: 'Overview of the Fern CLI including usage, installation, and CI/CD environments'
+description: Learn how to use the Fern CLI to manage API projects, validate definitions, preview changes, and publish docs and SDKs.
 ---
 
 The Fern CLI lets you initialize projects, validate API definitions, preview changes locally, and publish documentation and SDKs. This page covers installation and common commands to get you started.
diff --git a/fern/products/docs/pages/api-references/customize-api-ref.mdx b/fern/products/docs/pages/api-references/customize-api-ref.mdx
@@ -1,6 +1,6 @@
 ---
 title: Customize API Reference layout
-description: Customize your API Reference's naming, ordering, and structure.  
+description: Customize your API reference layout with Fern. Order sections and endpoints, flatten navigation, hide endpoints, and add custom content.
 ---
 
 When you [include an API in your `docs.yml` file](/learn/docs/api-references/generate-api-ref), you can customize how the endpoints and sections are displayed in the sidebar navigation. By default, the reference will generate a navigation hierarchy based on the structure of the API spec, but several customizations can be configured.
diff --git a/fern/products/docs/pages/component-library/custom-components/css-selectors.mdx b/fern/products/docs/pages/component-library/custom-components/css-selectors.mdx
@@ -1,6 +1,6 @@
 ---
 title: CSS selectors reference
-description: Complete reference of all Fern CSS selectors available for customizing your documentation site.
+description: Reference guide for all .fern-* CSS selectors available in Fern docs. Customize layouts, navigation, buttons, forms, accordions, badges, API components, and theme modes.
 max-toc-depth: 3
 ---
 
diff --git a/fern/products/docs/pages/component-library/custom-components/custom-css-js.mdx b/fern/products/docs/pages/component-library/custom-components/custom-css-js.mdx
@@ -1,7 +1,7 @@
 ---
 title: Fully customize your docs
 subtitle: Add custom CSS, global JavaScript, and UI components. 
-description: Add brand-specific styling, user interactions. and components to make your docs your own.
+description: Learn how to add custom CSS, JavaScript, and UI components to your Fern documentation. Style your docs with custom classes and scripts.
 ---
 
 This page covers how to customize your docs with CSS, JavaScript, and custom components. However, you can [customize many things directly in your `docs.yml` file](/docs/configuration/site-level-settings), including colors, typography, navbar links, layout, analytics, and metadata. Try these built-in options first before adding custom code. 
diff --git a/fern/products/docs/pages/component-library/default-components/accordions.mdx b/fern/products/docs/pages/component-library/default-components/accordions.mdx
@@ -1,6 +1,6 @@
 ---
 title: Accordion
-description: Display expandable/collapsible options with browser search functionality
+description: Add expandable Accordion sections to your Fern documentation. Perfect for FAQs, settings panels, and progressive content disclosure.
 ---
 
 The `<Accordion>` component creates expandable sections with searchable, SEO-friendly content that remains accessible even when collapsed. Use accordions for FAQs, documentation sections, settings panels, or any content where progressive disclosure improves readability.
diff --git a/fern/products/docs/pages/component-library/default-components/button.mdx b/fern/products/docs/pages/component-library/default-components/button.mdx
@@ -1,6 +1,6 @@
 ---
-title: 'Button'
-description: 'Interactive button component with multiple variants and intents'
+title: Button
+description: Learn how to use the Button component in Fern docs. Create interactive buttons with custom styles, sizes, intents, and icons.
 ---
 
 The `<Button>` component renders interactive buttons with various styles, sizes, and intents.
diff --git a/fern/products/docs/pages/component-library/default-components/download.mdx b/fern/products/docs/pages/component-library/default-components/download.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Download"
-description: "Download assets like PDFs directly from your documentation"
+title: Download
+description: The Download component enables users to download PDFs and files from your documentation. Simple setup with custom filenames.
 ---
 
 The `<Download>` component lets users download assets like PDFs directly from your documentation.
diff --git a/fern/products/docs/pages/component-library/default-components/endpoint-request-snippet.mdx b/fern/products/docs/pages/component-library/default-components/endpoint-request-snippet.mdx
@@ -1,6 +1,6 @@
 ---
-title: 'Endpoint request snippet'
-description: 'Reference an endpoint request from your API Reference'
+title: Endpoint request snippet
+description: Learn how to use EndpointRequestSnippet components in Fern to reference API endpoint requests in your documentation with code examples.
 ---
 
 Use the `<EndpointRequestSnippet>` components to reference an endpoint request from 
diff --git a/fern/products/docs/pages/component-library/default-components/icons.mdx b/fern/products/docs/pages/component-library/default-components/icons.mdx
@@ -1,6 +1,6 @@
 ---
-title: 'Icon'
-description: 'Use Font Awesome icons in your documentation'
+title: Icon
+description: Learn how to add Font Awesome icons to your Fern documentation. Customize icon sizes, colors, and styles with the Icon component.
 ---
 
 The `<Icon>` component displays [Font Awesome](https://fontawesome.com/) icons in your documentation with support for all Font Awesome Pro styles.
diff --git a/fern/products/docs/pages/component-library/default-components/indent.mdx b/fern/products/docs/pages/component-library/default-components/indent.mdx
@@ -1,6 +1,6 @@
 ---
 title: Indent
-description: Add left indentation with guide lines for nested content
+description: Learn how to use the Indent component in Fern to add left indentation with vertical guide lines for nested parameters and hierarchical content.
 ---
 
 The `<Indent>` component adds left indentation with a vertical guide line. It's a subtle visual aid that helps maintain readability in long API pages with multiple levels of nested parameters, and for blockquotes.
diff --git a/fern/products/docs/pages/component-library/default-components/parameter-fields.mdx b/fern/products/docs/pages/component-library/default-components/parameter-fields.mdx
@@ -1,6 +1,6 @@
 ---
-title: 'Parameter field'
-description: 'Display API parameter information with metadata like type, requirements, and descriptions'
+title: Parameter field
+description: Learn how to document API parameters with Fern's ParamField component. Format types, requirements, defaults, and descriptions consistently.
 ---
 
 The ParamField component documents API parameters and properties with consistent formatting for type, requirements, default values, and descriptions.
diff --git a/fern/products/docs/pages/component-library/default-components/schema-snippet.mdx b/fern/products/docs/pages/component-library/default-components/schema-snippet.mdx
@@ -1,6 +1,6 @@
 ---
 title: Schema snippet
-description: Display a type definition as a JSON code block
+description: Learn how to use the SchemaSnippet component in Fern to display API type definitions as JSON code blocks in your documentation.
 ---
 
 The `<SchemaSnippet>` component displays type definitions from your API Reference as a JSON code block. Use it on its own to display the JSON representation, or pair it with the [`<Schema>`](/learn/docs/writing-content/components/schema) component to show both the field-by-field breakdown and JSON together.
diff --git a/fern/products/docs/pages/component-library/default-components/steps.mdx b/fern/products/docs/pages/component-library/default-components/steps.mdx
@@ -1,6 +1,6 @@
 ---
-title: 'Step'
-description: 'Display a sequence of instructions or tasks with automatic numbering and anchor links.'
+title: Step
+description: Learn how to use the Steps component in Fern Docs to create sequential tutorials and walkthroughs with automatic numbering.
 ---
 
 The `<Steps>` component organizes sequential content with automatic numbering and anchor links. Use steps for tutorials, walkthroughs, setup guides, or any content that needs to be followed in order.
diff --git a/fern/products/docs/pages/component-library/default-components/tooltips.mdx b/fern/products/docs/pages/component-library/default-components/tooltips.mdx
@@ -1,6 +1,6 @@
 ---
 title: Tooltip
-description: Add interactive tooltips to your documentation.
+description: Learn how to add interactive tooltips to your documentation. Display contextual information on hover for text and code elements.
 ---
 
 The `<Tooltip>` component displays additional information when users hover over text or code elements. Use tooltips to provide context, definitions, or explanations without cluttering your documentation.
diff --git a/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx b/fern/products/docs/pages/component-library/writing-content/visual-editor.mdx
@@ -1,6 +1,6 @@
 ---
 title: Fern Editor
-description: Update your docs visually with a GitHub-backed workflow that creates pull requests.
+description: Update your documentation without learning Git or markdown. Fern Editor offers visual editing for non-technical teams with full GitHub integration.
 ---
 
 Fern Editor lets anyone on your team update documentation without learning code, markdown, or Git. Perfect for non-technical teammates like content writers, product managers, and marketers who want to contribute to docs without needing developer setup.
diff --git a/fern/products/docs/pages/getting-started/overview.mdx b/fern/products/docs/pages/getting-started/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Fern Docs
-subtitle: A website builder for beautiful agent and developer-friendly docs.
+subtitle: Build beautiful, interactive documentation websites with Fern Docs. Create API references, custom components, and AI-powered features in under 5 minutes.
 ---
 
 <div className="docs-homepage">
diff --git a/fern/products/docs/pages/getting-started/preview-changes-locally.mdx b/fern/products/docs/pages/getting-started/preview-changes-locally.mdx
@@ -1,6 +1,6 @@
 ---
 title: Preview changes
-description: Preview changes to your docs locally or with shareable preview links.
+description: Learn how to preview documentation changes with Fern using local development servers and shareable preview links before publishing.
 ---
 
 Fern offers two ways to preview documentation changes:
diff --git a/fern/products/docs/pages/getting-started/quickstart.mdx b/fern/products/docs/pages/getting-started/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: Quickstart
-description: Start building beautiful documentation in under 5 minutes
+description: Learn how to build beautiful developer documentation with Fern in under 5 minutes. Install CLI, add Markdown content, generate API references, and publish.
 ---
 
 Build beautiful developer documentation that [matches your brand](https://buildwithfern.com/customers) with Fern. Fern supports writing pages in Markdown and generating API Reference documentation from an OpenAPI Specification.
diff --git a/fern/products/docs/pages/integrations/analytics/google.mdx b/fern/products/docs/pages/integrations/analytics/google.mdx
@@ -1,6 +1,6 @@
 ---
 title: Google Analytics
-subtitle: Learn how to add Google Analytics to your Fern Docs for tracking and insights.
+subtitle: Integrate Google Analytics 4 and Google Tag Manager with Fern Docs. Complete setup instructions for tracking website traffic and insights.
 ---
 
 Fern supports integrating with both [Google Analytics 4](https://developers.google.com/analytics) and [Google Tag Manager](https://tagmanager.google.com/).
diff --git a/fern/products/docs/pages/integrations/analytics/posthog.mdx b/fern/products/docs/pages/integrations/analytics/posthog.mdx
@@ -1,6 +1,6 @@
 ---
 title: PostHog
-description: Learn how to integrate PostHog with Fern Docs!
+description: Learn how to add PostHog analytics to your Fern documentation. Configure your PostHog API key and custom endpoint.
 ---
 
 Integrate PostHog to track user behavior and analytics in your documentation, including page views, feature usage, and user interactions.
diff --git a/fern/products/docs/pages/integrations/analytics/segment.mdx b/fern/products/docs/pages/integrations/analytics/segment.mdx
@@ -1,6 +1,6 @@
 ---
 title: Segment
-description: Learn how to integrate Fern Docs with Segment to track user behavior and analytics.
+description: Learn how to add Segment analytics to your Fern documentation. Step-by-step guide to configure your Segment writeKey.
 ---
 
 Integrate Segment to collect analytics and route user data to your preferred analytics destinations.
diff --git a/fern/products/docs/pages/integrations/postman.mdx b/fern/products/docs/pages/integrations/postman.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Postman integration"
-description: "Generate a Postman collection full of example requests and responses"
+title: Postman integration
+description: Generate Postman collections from API definitions with Fern. Create example requests and responses for testing and exploring APIs.
 ---
 
 [Postman](https://www.postman.com/) is an API platform for testing and exploring APIs.
diff --git a/fern/products/docs/pages/navigation/products.mdx b/fern/products/docs/pages/navigation/products.mdx
@@ -1,6 +1,6 @@
 ---
 title: Product switching
-subtitle: Allow users to seamlessly navigate between different products you offer. 
+subtitle: Learn how to configure product switching in Fern Docs. Set up multiple products with custom navigation, versioning, and styling options.
 ---
 
 <Markdown src="/snippets/pro-plan.mdx"/>
diff --git a/fern/products/docs/pages/navigation/tabs.mdx b/fern/products/docs/pages/navigation/tabs.mdx
@@ -1,6 +1,6 @@
 ---
 title: Tabs and tab variants
-description: Organize your documentation with tabs and show different content variations using tab variants.
+description: Learn how to configure tabs and tab variants in Fern documentation. Group content sections with custom icons and display multiple perspectives.
 ---
 
 Tabs let you group sections of your documentation together, while tab variants allow you to display different content perspectives within a single tab.
diff --git a/fern/products/docs/pages/navigation/versions.mdx b/fern/products/docs/pages/navigation/versions.mdx
@@ -1,6 +1,6 @@
 ---
 title: Versioning
-subtitle: Allow users to navigate between different versions of your docs. 
+subtitle: Learn how to add versioning to your Fern documentation. Configure multiple doc versions, customize version selectors, and manage version-specific content.
 ---
 
 <Warning>
diff --git a/fern/products/docs/pages/security/overview.mdx b/fern/products/docs/pages/security/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Security
-description: Learn how Fern handles authentication and user credentials in documentation sites.
+description: Learn how Fern's documentation platform secures your API docs with client-side authentication, API key injection, and self-hosted options.
 ---
 
 Fern's documentation platform is built with security as a core principle, using a client-side architecture for authentication and credential handling. User credentials and sensitive data are stored only in browser cookies and never transmitted to Fern's servers.
diff --git a/fern/products/docs/pages/seo/metadata.mdx b/fern/products/docs/pages/seo/metadata.mdx
@@ -1,6 +1,6 @@
 ---
 title: Configure SEO metadata
-description: Configure SEO metadata at the page or site level.  
+description: Configure SEO metadata in Fern docs with page-level frontmatter and site-wide settings. Control titles, descriptions, and social media previews.
 ---
 
 Fern automatically generates all SEO metadata for every page in your documentation site. Search engines and social media previews work out of the box with no configuration required.
diff --git a/fern/products/docs/pages/seo/redirects.mdx b/fern/products/docs/pages/seo/redirects.mdx
@@ -1,6 +1,6 @@
 ---
 title: Configure links and redirects for your site
-subtitle: Set up the navigation for your documentation site built with Fern Docs using the docs.yml file
+subtitle: Learn how to configure redirects and external links in Fern Docs. Set up exact path redirects, regex patterns, and navigation links for your documentation site.
 ---
 
 ## Redirects
diff --git a/fern/products/home/pages/welcome.mdx b/fern/products/home/pages/welcome.mdx
@@ -1,7 +1,7 @@
 ---
 title: Build with Fern
 slug: /
-description: Explore our guides for how to generate SDKs and Docs with Fern.
+description: Build better developer experiences with Fern. Generate SDKs in TypeScript, Python, Go, Java, C#, PHP, Ruby, Swift & Rust. Create interactive API docs with AI search.
 hide-toc: true
 layout: custom
 ---
diff --git a/fern/products/sdks/capabilities.mdx b/fern/products/sdks/capabilities.mdx
@@ -1,7 +1,7 @@
 ---
 title: Capabilities
 subtitle: Fern SDKs are built to have every feature you need.
-description: Fern SDKs are built to have every feature you need.
+description: Fern SDK capabilities include type safety, auto-pagination, OAuth token refresh, retries with backoff, webhook verification, and more.
 layout: overview
 ---
 
diff --git a/fern/products/sdks/guides/filter-your-endpoints-audiences.mdx b/fern/products/sdks/guides/filter-your-endpoints-audiences.mdx
@@ -1,6 +1,6 @@
 ---
 title: Filter your endpoints (audiences)
-description: Guide to filtering your API endpoints using audiences.
+description: Learn how to filter API endpoints using audiences in Fern SDKs. Generate tailored client libraries for internal teams, beta testers, and customers.
 ---
 
 <Markdown src="/snippets/pro-plan.mdx"/>
diff --git a/fern/products/sdks/guides/retries-with-backoff.mdx b/fern/products/sdks/guides/retries-with-backoff.mdx
@@ -1,6 +1,6 @@
 ---
 title: Retries with backoff
-description: Automatically retry failures with exponential backoff
+description: Learn how to configure automatic retries with exponential backoff in Fern SDKs. Control retry limits and customize retryable status codes.
 ---
 
 <Markdown src="/snippets/pro-plan.mdx" />
diff --git a/fern/products/sdks/guides/setup-local-sdk-previews.mdx b/fern/products/sdks/guides/setup-local-sdk-previews.mdx
@@ -1,6 +1,6 @@
 ---
 title: Set up local SDK previews
-description: Use Fern's CLI tool to preview your SDK locally.
+description: Learn how to set up local SDK previews with Fern's --preview flag. Test generated SDK code locally before publishing to iterate quickly.
 ---
 
 Once you configure your SDK, you can use the `--preview` flag to test generated
diff --git a/fern/products/sdks/overview/csharp/configuration.mdx b/fern/products/sdks/overview/csharp/configuration.mdx
@@ -1,6 +1,6 @@
 ---
 title: .NET configuration
-description: Configuration options for the Fern .NET SDK.
+description: Configure your C# .NET SDK generator with Fern. Customize client class names, namespaces, error handling, and pagination settings.
 ---
 
 You can customize the behavior of the C#/.NET SDK generator in `generators.yml`:
diff --git a/fern/products/sdks/overview/csharp/quickstart.mdx b/fern/products/sdks/overview/csharp/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: .NET quickstart
-description: Get started quickly with the Fern .NET SDK.
+description: Generate a C#/.NET SDK with Fern's SDK generator. Follow step-by-step instructions to configure, build, and publish your client library.
 ---
 
 Generate a C#/.NET SDK by following the instructions on this page. 
diff --git a/fern/products/sdks/overview/go/quickstart.mdx b/fern/products/sdks/overview/go/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: Go quickstart
-description: Get started quickly with the Fern Go SDK.
+description: Learn how to generate a Go SDK with Fern. Step-by-step guide to configure generators.yml, run fern generate, and create Go client libraries.
 ---
 
 Generate a Go SDK by following the instructions on this page. 
diff --git a/fern/products/sdks/overview/java/publishing-to-maven-central.mdx b/fern/products/sdks/overview/java/publishing-to-maven-central.mdx
@@ -1,6 +1,6 @@
 ---
 title: Publishing to Maven Central
-description: How to publish the Fern Java SDK to Maven Central.
+description: Learn how to publish your Fern-generated Java SDK to Maven Central. Complete guide covering authentication, GPG signatures, and automated releases.
 ---
 
 Publish your public-facing Fern Java SDK to the [Maven Central
diff --git a/fern/products/sdks/overview/java/quickstart.mdx b/fern/products/sdks/overview/java/quickstart.mdx
@@ -1,6 +1,6 @@
 ---
 title: Java quickstart
-description: Get started quickly with the Fern Java SDK.
+description: Learn how to generate a Java SDK with Fern. Step-by-step guide to configure generators.yml, run fern generate, and create client libraries.
 ---
 
 Generate a Java SDK by following the instructions on this page. 
diff --git a/fern/products/sdks/overview/ruby/publishing-to-rubygems.mdx b/fern/products/sdks/overview/ruby/publishing-to-rubygems.mdx
@@ -1,6 +1,6 @@
 ---
 title: Publishing to RubyGems
-description: How to publish the Fern Ruby SDK to RubyGems.
+description: Publish Ruby SDKs to RubyGems with Fern. Complete setup guide for package configuration, API key authentication, and versioned releases.
 ---
 
 Publish your public-facing Fern Ruby SDK to the [RubyGems
diff --git a/fern/products/sdks/overview/swift/configuration.mdx b/fern/products/sdks/overview/swift/configuration.mdx
@@ -1,6 +1,6 @@
 ---
 title: Swift configuration
-description: Configuration options for the Fern Swift SDK.
+description: Configure Swift SDK generator settings including clientClassName, moduleName, environmentEnumName, and nullableAsOptional options.
 ---
 
 You can customize the behavior of the Swift SDK generator in `generators.yml`:
