diff --git a/README.md b/README.md
index bca2b2e15..ce1474d42 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,7 @@ Keep the following principles in mind:
 - **Use [Fern’s documentation components](https://buildwithfern.com/learn/docs/writing-content/components/overview)** whenever you can.
 - **When editing an existing page** - Match the existing heading structure, tone, and level of detail to ensure your changes integrate as seamlessly as possible.
 - **Use diagrams when it makes sense** – Show, don't tell! Use [Mermaid](https://buildwithfern.com/learn/docs/writing-content/markdown#diagrams), a Markdown-like diagramming syntax, to illustrate a workflow. 
+- [**Use sentence case**](https://developers.google.com/style/capitalization) for page and section headings. 
 
 > "Break any of these rules sooner than say anything outright barbarous."
 > 
diff --git a/fern/products/ask-fern/ask-fern.yml b/fern/products/ask-fern/ask-fern.yml
index 12b717847..530c7ade6 100644
--- a/fern/products/ask-fern/ask-fern.yml
+++ b/fern/products/ask-fern/ask-fern.yml
@@ -1,5 +1,5 @@
 navigation:
-  - section: Getting Started
+  - section: Getting started
     contents:
       - page: What is Ask Fern?
         path: ./pages/getting-started/what-is-ask-fern.mdx
@@ -15,7 +15,7 @@ navigation:
         path: ./pages/features/citations.mdx
       - page: Custom FAQs
         path: ./pages/features/custom-faqs.mdx
-  - api: API Reference
+  - api: API reference
     api-name: fai
     icon: fa-regular fa-pro
     paginated: true
diff --git a/fern/products/cli-api-reference/cli-api-reference.yml b/fern/products/cli-api-reference/cli-api-reference.yml
index a97fe348f..20a46c183 100644
--- a/fern/products/cli-api-reference/cli-api-reference.yml
+++ b/fern/products/cli-api-reference/cli-api-reference.yml
@@ -1,16 +1,16 @@
 navigation:
   - section: CLI Reference
     contents:
-      - page: Get Started with Fern CLI
+      - page: Get started with Fern CLI
         path: ./pages/cli-get-started.mdx
         slug: overview
-      - page: Global Options
+      - page: Global options
         path: ./pages/global-options.mdx
         slug: options
       - page: Commands
         path: ./pages/commands.mdx
       - changelog: ./cli-changelog
-  - api: API Reference
+  - api: API reference
     api-name: public-api
     icon: fa-regular fa-pro
     paginated: true
diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml
index ddb3dbc7b..068ef42b5 100644
--- a/fern/products/docs/docs.yml
+++ b/fern/products/docs/docs.yml
@@ -1,20 +1,33 @@
 navigation:
-  - section: Getting Started
+  - section: Getting started
     contents:
       - page: Overview
         path: ./pages/getting-started/overview.mdx
       - page: Quickstart
         path: ./pages/getting-started/quickstart.mdx
-      - page: Project Structure
+      - page: Project structure
         path: ./pages/getting-started/project-structure.mdx
-      - link: Customer Showcase
+      - link: Customer showcase
         href: https://buildwithfern.com/showcase#docs-customers.alldocs-features
   - changelog: ./pages/changelog
     icon: fa-regular fa-clock-rotate-left
-  - section: Writing Content
+  - section: Configuration
+    contents:
+      - page: What is docs.yml?
+        path: ./pages/customization/what-is-docs-yml.mdx
+      - page: Navigation
+        path: ./pages/navigation/overview.mdx
+      - page: Versions
+        path: ./pages/navigation/versions.mdx
+      - page: Products
+        path: ./pages/navigation/products.mdx
+      - page: Page-level settings
+        path: ./pages/customization/frontmatter.mdx
+  - section: Writing content
     contents:
-      - page: Markdown
+      - page: Markdown pages
         path: ./pages/component-library/writing-content/markdown.mdx
+        slug: markdown
       - section: Components
         contents:
           - page: Overview
@@ -79,26 +92,16 @@ navigation:
             icon: fa-duotone fa-comment
       - page: Visual Editor
         path: ./pages/component-library/writing-content/visual-editor.mdx
-      - page: Reusable Markdown
+      - page: Reusable snippets
         path: ./pages/component-library/custom-components/reusable-markdown.mdx
-      - page: Custom React Components
+        slug: reusable-markdown
+      - page: Custom React components
         path: ./pages/component-library/custom-components/custom-react-components.mdx
-      - page: Conditionally Rendered Content
+      - page: Conditionally rendered content
         hidden: true
         path: ./pages/component-library/custom-components/conditional-rendering.mdx
-  - section: Configuration
-    contents:
-      - page: What is docs.yml
-        path: ./pages/customization/what-is-docs-yml.mdx
-      - page: Navigation
-        path: ./pages/navigation/overview.mdx
-      - page: Versions
-        path: ./pages/navigation/versions.mdx
-      - page: Products
-        path: ./pages/navigation/products.mdx
-      - page: Page-level settings
-        path: ./pages/customization/frontmatter.mdx
-  - section: Preview & Publish
+
+  - section: Preview & publish
     collapsed: true
     contents:
       - page: Previewing changes locally 
@@ -112,58 +115,58 @@ navigation:
   - section: Customization
     collapsed: true
     contents:
-      - page: Announcement Banner
+      - page: Announcement banner
         path: ./pages/navigation/announcement-banner.mdx
       - page: Changelogs
         path: ./pages/navigation/changelogs.mdx
-      - page: Hiding Content
+      - page: Hiding content
         path: ./pages/navigation/hiding-content.mdx
       - page: Search
         path: ./pages/customization/search.mdx
-      - page: User Feedback
+      - page: User feedback
         path: ./pages/customization/user-feedback.mdx
       - page: Custom CSS & JS
         path: ./pages/component-library/custom-components/custom-css-js.mdx
-  - section: API References
+  - section: API references
     collapsed: true
     contents:
-      - page: Generate API Reference
+      - page: Generate API reference
         path: ./pages/api-references/generate-api-ref.mdx
         slug: generate-api-ref
-      - page: SDK Snippets
+      - page: SDK snippets
         path: ./pages/api-references/sdk-snippets.mdx
-      - page: HTTP Snippets
+      - page: HTTP snippets
         path: ./pages/api-references/http-snippets.mdx
       - section: API Explorer
         slug: api-explorer
         contents:
           - page: Overview
             path: ./pages/api-references/api-explorer.mdx
-          - page: Auto-populate API Keys
+          - page: Auto-populate API keys
             path: ./pages/api-references/autopopulate-api-key.mdx
-      - page: Endpoint Errors
+      - page: Endpoint errors
         path: ./pages/api-references/endpoint-errors.mdx
       - page: Audiences
         path: ./pages/api-references/audiences.mdx
-      - page: Customize API Reference Layout
+      - page: Customize API reference layout
         path: ./pages/api-references/customize-api-ref.mdx
-      - page: Write Markdown in API Reference
+      - page: Write Markdown in API reference
         path: ./pages/api-references/api-ref-content.mdx
-      - page: Generate Webhook Reference
+      - page: Generate Webhook reference
         path: ./pages/api-references/generate-webhook-ref.mdx
-      - page: Multiple Server URLs
+      - page: Multiple server URLs
         path: ./pages/api-references/server-urls.mdx
         slug: server-urls
-      - page: Generate WebSocket Reference
+      - page: Generate WebSocket reference
         path: ./pages/api-references/generate-websocket-ref.mdx
         slug: generate-websocket-ref
-      - page: Generate OpenRPC Reference
+      - page: Generate OpenRPC reference
         path: ./pages/api-references/generate-openrpc-ref.mdx
         slug: generate-openrpc-ref
   - section: SEO
     collapsed: true
     contents:
-      - page: Configuring Slugs
+      - page: Configuring slugs
         path: ./pages/seo/configuring-slugs.mdx
       - page: Redirects
         path: ./pages/seo/redirects.mdx
@@ -177,11 +180,11 @@ navigation:
       - page: Role based access control (RBAC)
         path: ./pages/authentication/rbac.mdx
         slug: rbac
-      - page: API Key Injection
+      - page: API key injection
         path: ./pages/api-references/autopopulate-api-key.mdx
       - page: SSO
         path: ./pages/authentication/sso.mdx
-  -  section: Self-Hosted
+  -  section: Self-hosted
      collapsed: true
      contents:
       - page: Overview
@@ -210,9 +213,9 @@ navigation:
             path: ./pages/integrations/support/intercom.mdx
       - page: Postman
         path: ./pages/integrations/postman.mdx
-      - page: LaunchDarkly Feature Flags 
+      - page: LaunchDarkly feature flags 
         path: ./pages/integrations/feature-flags.mdx
-  - section: Developer Tools
+  - section: Developer tools
     collapsed: true
     contents:
       - page: Cursor
diff --git a/fern/products/docs/pages/developer-tools/view-markdown.mdx b/fern/products/docs/pages/developer-tools/view-markdown.mdx
index 54d5a0af9..dd34fdb8b 100644
--- a/fern/products/docs/pages/developer-tools/view-markdown.mdx
+++ b/fern/products/docs/pages/developer-tools/view-markdown.mdx
@@ -3,7 +3,7 @@ title: View Markdown
 description: Learn how to view the Markdown underlying a documentation page, to help with tool integration and troubleshooting.
 ---
 
-Adding `.md` to the end of a documentation page's URL shows its source Markdown, excluding frontmatter. This works for both normal and API reference pages.
+Adding `.md` or `.mdx` to the end of a documentation page's URL shows its source Markdown, excluding frontmatter. This works for both normal and API reference pages.
 
 <Tip>Displaying the page's Markdown helps with troubleshooting layout problems and makes it easier to process page content with external tools or AI agents.</Tip>
 
diff --git a/fern/products/docs/pages/getting-started/overview.mdx b/fern/products/docs/pages/getting-started/overview.mdx
index 58ff1c2eb..a3543807b 100644
--- a/fern/products/docs/pages/getting-started/overview.mdx
+++ b/fern/products/docs/pages/getting-started/overview.mdx
@@ -115,7 +115,7 @@ subtitle: A website builder for beautiful agent and developer-friendly docs.
             <img src="./images/arrow-right-white.svg" alt="Arrow right light" className="arrow-right hidden dark:block m-0" noZoom />
           </div>
           <div class="text-(color:--grayscale-a11) font-light">
-            <p>A personalized chatbot that can answer questions about your documentation.</p>
+            <p>Get instant answers to questions about your docs from a personalized chatbot.</p>
           </div>
         </div>
       </div>
diff --git a/fern/products/sdks/sdks.yml b/fern/products/sdks/sdks.yml
index 83aaf6a49..b3842290d 100644
--- a/fern/products/sdks/sdks.yml
+++ b/fern/products/sdks/sdks.yml
@@ -7,16 +7,16 @@ navigation:
       - page: Quickstart
         path: ./fern-folder.mdx
         slug: quickstart
-      - page: Project Structure
+      - page: Project structure
         path: ./github-setup.mdx
         slug: github
-      - page: Adding Custom Code
+      - page: Adding custom code
         path: ./custom-code.mdx
         slug: custom-code
       - page: Capabilities
         path: ./capabilities.mdx
         slug: capabilities
-      - link: Customer Showcase
+      - link: Customer showcase
         href: https://buildwithfern.com/showcase
   - section: Generators
     contents:
@@ -26,7 +26,7 @@ navigation:
           - page: Quickstart
             path: ./overview/typescript/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/typescript/design.mdx
             slug: design
@@ -41,14 +41,14 @@ navigation:
             slug: custom-code
           - changelog: ./overview/typescript/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.typescript
       - section: Python
         contents:
           - page: Quickstart
             path: ./overview/python/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/python/design.mdx
             slug: design
@@ -63,21 +63,21 @@ navigation:
             slug: custom-code
           - changelog: ./overview/python/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.python
       - section: Go
         contents:
           - page: Quickstart
             path: ./overview/go/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/go/design.mdx
             slug: design
           - page: Configuration
             path: ./overview/go/configuration.mdx
             slug: configuration
-          - page: Publishing as a Go Module
+          - page: Publishing as a Go module
             path: ./overview/go/publishing-to-go-package-manager.mdx
             slug: publishing
           - page: Adding custom code
@@ -85,14 +85,14 @@ navigation:
             slug: custom-code
           - changelog: ./overview/go/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.go
       - section: Java
         contents:
           - page: Quickstart
             path: ./overview/java/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/java/design.mdx
             slug: design
@@ -107,7 +107,7 @@ navigation:
             slug: custom-code
           - changelog: ./overview/java/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.java
       - section: .NET
         slug: csharp
@@ -115,7 +115,7 @@ navigation:
           - page: Quickstart
             path: ./overview/csharp/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/csharp/design.mdx
             slug: design
@@ -131,14 +131,14 @@ navigation:
             slug: custom-code
           - changelog: ./overview/csharp/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.net
       - section: PHP
         contents:
           - page: Quickstart
             path: ./overview/php/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/php/design.mdx
             slug: design
@@ -154,14 +154,14 @@ navigation:
             slug: custom-code
           - changelog: ./overview/php/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.php
       - section: Ruby
         contents:
           - page: Quickstart
             path: ./overview/ruby/quickstart.mdx
             slug: quickstart
-          - page: Design Decisions
+          - page: Design decisions
             hidden: true
             path: ./overview/ruby/design.mdx
             slug: design
@@ -177,29 +177,29 @@ navigation:
             slug: custom-code
           - changelog: ./overview/ruby/changelog
             slug: changelog
-          - link: Customer Showcase
+          - link: Customer showcase
             href: https://buildwithfern.com/showcase#sdk-customers.ruby
       - page: MCP Server
         path: ./overview/mcp-server/introduction.mdx
         slug: mcp-server
-  - section: Deep Dives
+  - section: Deep dives
     contents:    
-      - page: Customize Method Names
+      - page: Customize method names
         path: ./guides/customize-method-names.mdx
         slug: customize-method-names
       - page: Setup local SDK previews
         path: ./guides/setup-local-sdk-previews.mdx
         slug: local-previews
-      - page: Configure Global Headers
+      - page: Configure global headers
         path: ./guides/configure-global-headers.mdx
         slug: global-headers
-      - page: Configure Auto-Pagination
+      - page: Configure auto-pagination
         path: ./guides/configure-auto-pagination.mdx
         slug: auto-pagination
-      - page: Configure Idempotency
+      - page: Configure idempotency
         path: ./guides/configure-idempotency.mdx
         slug: idempotency
-      - page: Filter Your Endpoints (Audiences)
+      - page: Filter your endpoints (audiences)
         path: ./guides/filter-your-endpoints-audiences.mdx
         slug: audiences
       - page: Customize your README
@@ -207,7 +207,7 @@ navigation:
         slug: readme
       - page: Retries with Backoff
         path: ./guides/retries-with-backoff.mdx
-      - page: Self-Hosted SDKs
+      - page: Self-hosted SDKs
         path: ./guides/self-hosted.mdx
         slug: self-hosted
   - section: Reference