Merge branch 'main' into fern/writer-pr-attribution

Author: devalog

.github/CODEOWNERS

@@ -0,0 +1,2 @@
+* @devalog
+

.github/workflows/stale-bot.yml

@@ -12,7 +12,7 @@ jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v10
         with:
           stale-pr-message: 'This PR is stale because it has been open 25 days with no activity. Remove stale label or comment or this will be closed in 5 days.'
           close-pr-message: 'This PR was closed because it has been inactive for 5 days after being marked stale.'

.vale/styles/FernStyles/Acronyms.yml

@@ -105,3 +105,4 @@ exceptions:
   - UUID
   - WSS
   - GEO
+  - SPDX

.vale/styles/FernStyles/Headings.yml

@@ -85,3 +85,4 @@ exceptions:
   - MDN
   - WSS
   - GEO
+  - OG

fern/apis/fai/openapi.json

@@ -4513,6 +4513,58 @@
             "type": "string",
             "title": "Diff",
             "description": "The git diff to analyze for generating a commit message"
+          },
+          "language": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Language",
+            "description": "The SDK programming language, e.g. 'typescript', 'python', 'java'. When provided, enables language-specific breaking change rules and behavioral analysis.",
+            "default": null
+          },
+          "previous_version": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Previous Version",
+            "description": "The current published version before this change, e.g. '1.2.3'. Provided for context only \u2014 not included in the commit message.",
+            "default": null
+          },
+          "prior_changelog": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Prior Changelog",
+            "description": "The last 3 changelog entries for this SDK. Used to match existing commit message style. Empty string or null if none.",
+            "default": null
+          },
+          "spec_commit_message": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Spec Commit Message",
+            "description": "The commit message from the API spec repository that triggered this SDK generation. Used as a hint for the intent of the change. Empty string or null if unavailable.",
+            "default": null
           }
         },
         "type": "object",
@@ -4528,6 +4580,12 @@
             "title": "Message",
             "description": "The AI-generated commit message summarizing the changes in the diff"
           },
+          "changelog_entry": {
+            "type": "string",
+            "title": "Changelog Entry",
+            "description": "User-facing release note for CHANGELOG.md and GitHub Releases. Describes the impact on SDK consumers, not implementation details. Empty string for PATCH and NO_CHANGE.",
+            "default": ""
+          },
           "version_bump": {
             "$ref": "#/components/schemas/VersionBump",
             "description": "The recommended semantic version bump: MAJOR for breaking changes, MINOR for new features, PATCH for bug fixes and other changes, NO_CHANGE for empty diffs"
@@ -7641,4 +7699,4 @@
       "x-fern-server-name": "Local"
     }
   ]
-}
+}

fern/apis/generators-yml/definition/generators.yml

@@ -167,15 +167,22 @@ types:
       - v1
       - v2
 
+  OverridesSchema:
+    discriminated: false
+    docs: Paths to the overrides configuration. Can be a single path or an array of paths applied sequentially.
+    union:
+      - string
+      - list<string>
+
   APIDefinitionWithOverridesSchema:
     properties:
       path: APIDefinitionPathSchema
       origin:
         type: optional<string>
         docs: The URL of the API definition origin, from which the file should be polled.
       overrides:
-        type: optional<string>
-        docs: Path to the OpenAPI or AsyncAPI overrides
+        type: optional<OverridesSchema>
+        docs: Paths to the overrides configuration. Can be a single path or an array of paths applied sequentially.
       audiences:
         type: optional<list<string>>
         docs: Audiences that you would like to filter to
@@ -190,8 +197,8 @@ types:
         type: string
         docs: The path to the `.proto` directory root (e.g. `proto`).
       overrides:
-        type: optional<string>
-        docs: Path to the overrides configuration
+        type: optional<OverridesSchema>
+        docs: Paths to the overrides configuration. Can be a single path or an array of paths applied sequentially.
       local-generation:
         type: optional<boolean>
         docs: Whether to compile the `.proto` files locally. By default, we generate remotely.
@@ -324,14 +331,14 @@ types:
     properties:
       openapi: string
       origin: optional<string>
-      overrides: optional<string>
+      overrides: optional<OverridesSchema>
       namespace: optional<string>
       settings: optional<OpenAPISettingsSchema>
 
   OpenRPCSpecSchema: 
     properties:   
       openrpc: string
-      overrides: optional<string>
+      overrides: optional<OverridesSchema>
       namespace: optional<string>
 
   AsyncAPISettingsSchema:
@@ -346,7 +353,7 @@ types:
     properties:
       asyncapi: string
       origin: optional<string>
-      overrides: optional<string>
+      overrides: optional<OverridesSchema>
       namespace: optional<string>
       settings: optional<AsyncAPISettingsSchema>
 
@@ -367,4 +374,4 @@ types:
 
   ProtobufSpecSchema:
     properties:
-      proto: ProtobufDefinitionSchema
+      proto: ProtobufDefinitionSchema

fern/assets/styles.css

@@ -741,6 +741,7 @@ h1, h2, h3 {
       display: flex;
       flex-direction: row;
       align-items: center;
+      border-bottom: none;
     }
   }
 
@@ -831,7 +832,7 @@ h1, h2, h3 {
 
   .a-btn {
     text-decoration: none !important;
-    font-weight: 400 !important;
+    font-weight: 500 !important;
     width: fit-content !important;
 
     img {
@@ -1179,3 +1180,11 @@ h1, h2, h3 {
   }
 }
 /*** END -- HIGHLIGHTED FRAME STYLING ***/
+
+/*** START -- ASK AI PANEL STYLING ***/
+@media (min-width: 1024px) {
+  .fern-ask-ai-panel-header {
+    height: 76px;
+  }
+}
+/*** END -- ASK AI PANEL STYLING ***/

fern/components/FernFooter.tsx

@@ -36,7 +36,7 @@ export const FernFooter = () => {
 
       {/* Footer Links */}
       <div className="footer-links">
-        <div className="footer-bottom-text"> © 2025 Fern • Located in Brooklyn, NY </div>
+        <div className="footer-bottom-text"> © 2026 Fern • Birch Solutions, Inc., a Postman company</div>
         {/* Newsletter Signup */}
         {/* <div className="newsletter-container">
           <div className="newsletter-label">Subscribe to our updates</div>
@@ -81,4 +81,4 @@ export const FernFooter = () => {
       </div>
     </footer>
   );
-};
+};

fern/docs.yml

@@ -514,13 +514,17 @@ redirects:
   - source: /learn/openapi-definition/extensions/webhooks
     destination: /learn/api-definitions/openapi/endpoints/webhooks
   - source: /learn/api-definitions/openapi/overlay-customizations
-    destination: /learn/api-definitions/overview/overrides
+    destination: /learn/api-definitions/openapi/overrides
   - source: /learn/api-definitions/asyncapi/overlay-customizations
-    destination: /learn/api-definitions/overview/overrides
+    destination: /learn/api-definitions/asyncapi/overrides
   - source: /learn/api-definitions/openrpc/overlay-customizations
-    destination: /learn/api-definitions/overview/overrides
+    destination: /learn/api-definitions/openrpc/overrides
   - source: /learn/api-definitions/grpc/overlay-customizations
-    destination: /learn/api-definitions/overview/overrides
+    destination: /learn/api-definitions/grpc/overrides
+  - source: /learn/api-definitions/overview/overrides
+    destination: /learn/api-definitions/asyncapi/overrides
+  - source: /learn/api-definitions/overrides
+    destination: /learn/api-definitions/asyncapi/overrides
   - source: /learn/api-definitions/openapi/automatic-updates
     destination: /learn/api-definitions/openapi/sync-your-open-api-specification
 
@@ -549,48 +553,52 @@ redirects:
     destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/docs/ai-features/ask-fern/how-it-works
     destination: /learn/docs/ai-features/ask-fern/overview
+  - source: /learn/docs/ai-features/ask-fern/features
+    destination: /learn/docs/ai-features/ask-fern/overview
+  - source: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/configuration/setup
-    destination: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/configuration/guidance
     destination: /learn/docs/ai-features/ask-fern/guidance
   - source: /learn/ask-fern/configuration/content-sources
     destination: /learn/docs/ai-features/ask-fern/content-sources
   - source: /learn/ask-fern/features/analytics
-    destination: /learn/docs/ai-features/ask-fern/features#analytics
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/features/citations
-    destination: /learn/docs/ai-features/ask-fern/features#citations
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/features/insights
-    destination: /learn/docs/ai-features/ask-fern/features#insights
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/features/evaluation
-    destination: /learn/docs/ai-features/ask-fern/features#evaluation
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/features/rbac
-    destination: /learn/docs/ai-features/ask-fern/features#role-based-access-control
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/features/slack-app
     destination: /learn/docs/ai-features/ask-fern/slack-app
   - source: /learn/ask-fern/api-reference/overview
     destination: /learn/docs/ai-features/ask-fern/api-reference/overview
-  
+
   # Legacy Ask Fern redirects
   - source: /learn/ai-search/customer-showcase
     destination: https://buildwithfern.com/customers
   - source: /learn/ai-search/overview
     destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ai-search/custom-prompting
-    destination: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ai-search/citations
-    destination: /learn/docs/ai-features/ask-fern/features#citations
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/overview
     destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/customer-showcase
     destination: https://buildwithfern.com/customers
   - source: /learn/ask-fern/citations
-    destination: /learn/docs/ai-features/ask-fern/features#citations
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/custom-prompting
-    destination: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/configuration/locations-and-datasources
-    destination: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/configuration/custom-prompts
-    destination: /learn/docs/ai-features/ask-fern/setup
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ask-fern/configuration/documents
     destination: /learn/docs/ai-features/ask-fern/content-sources
   - source: /learn/ask-fern/features/scribe-slack-app
@@ -602,7 +610,7 @@ redirects:
   - source: /learn/ai-search/getting-started/:slug*
     destination: /learn/docs/ai-features/ask-fern/:slug*
   - source: /learn/ai-search/features/:slug*
-    destination: /learn/docs/ai-features/ask-fern/features
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ai-search/:slug*
     destination: /learn/docs/ai-features/ask-fern/:slug*
   - source: /learn/ask-fern/api-reference/:slug*
@@ -652,7 +660,7 @@ redirects:
   - source: /learn/api-definitions/openrpc/extensions/others
     destination: /learn/api-definitions/openrpc/extensions/overview
   - source: /learn/api-definitions/grpc/extensions/:slug*
-    destination: /learn/api-definitions/overview/overrides#definition-specific-extensions
+    destination: /learn/api-definitions/grpc/overrides
 
   # ============================================================================
   # ADDITIONAL /LEARN/* REDIRECTS FROM CRAWLED URLS FROM GOOGLE SEARCH CONSOLE
@@ -792,7 +800,7 @@ redirects:
 
   # Ask Fern redirects (additional)
   - source: /learn/ask-fern/features/custom-fa-qs
-    destination: /learn/docs/ai-features/ask-fern/features#citations
+    destination: /learn/docs/ai-features/ask-fern/overview
   - source: /learn/ai-search/getting-started/ai-search-customer-showcase
     destination: https://buildwithfern.com/showcase#ask-fern-customers
   - source: /learn/ask-fern/api-reference/conversations/get-conversation