reorganized and consolidate overrides info in API Def section

Author: devalog

fern/docs.yml

@@ -495,6 +495,18 @@ redirects:
   - source: /learn/openapi-definition/extensions/webhooks
     destination: /learn/api-definitions/openapi/endpoints/webhooks
     permanent: true
+  - source: /learn/api-definitions/openapi/overlay-customizations
+    destination: /learn/api-definitions/overview/overrides
+    permanent: true
+  - source: /learn/api-definitions/asyncapi/overlay-customizations
+    destination: /learn/api-definitions/overview/overrides
+    permanent: true
+  - source: /learn/api-definitions/openrpc/overlay-customizations
+    destination: /learn/api-definitions/overview/overrides
+    permanent: true
+  - source: /learn/api-definitions/grpc/overlay-customizations
+    destination: /learn/api-definitions/overview/overrides
+    permanent: true
 
   # API Definition Fern specific redirects first
   - source: /learn/api-definition/fern/endpoints/:slug*

fern/products/api-def/api-def.yml

@@ -5,6 +5,8 @@ navigation:
         path: ./pages/what-is-an-api-definition.mdx       
       - page: Project structure
         path: ./pages/project-structure.mdx
+      - page: Overrides
+        path: ./pages/overrides.mdx
   - section: OpenAPI
     collapsed: true
     slug: openapi
@@ -64,8 +66,6 @@ navigation:
       - section: Workflow & automation
         skip-slug: true
         contents:
-          - page: Overlay customizations
-            path: ./openapi-pages/overrides.mdx
           - page: Sync your OpenAPI specification
             path: ./openapi-pages/automation.mdx            
       - section: Integrate your server framework
@@ -127,8 +127,6 @@ navigation:
       - section: Workflow & automation
         skip-slug: true
         contents:
-          - page: Overlay customizations
-            path: ./asyncapi-pages/overrides.mdx
           - page: Sync your AsyncAPI specification
             path: ./asyncapi-pages/automation.mdx  
   - section: OpenRPC
@@ -190,8 +188,6 @@ navigation:
       - section: Workflow & automation
         skip-slug: true
         contents:
-          - page: Overlay customizations
-            path: ./openrpc-pages/overrides.mdx
           - page: Sync your OpenRPC specification
             path: ./openrpc-pages/automation.mdx    
   - section: gRPC
@@ -257,8 +253,6 @@ navigation:
       - section: Workflow & automation
         skip-slug: true
         contents:
-          - page: Overlay customizations
-            path: ./grpc-pages/overrides.mdx
           - page: Sync your gRPC specification
             path: ./grpc-pages/automation.mdx
   - section: Fern Definition

fern/products/api-def/asyncapi-pages/extensions/overview.md

@@ -3,7 +3,9 @@ title: Overview of AsyncAPI extensions
 description: Learn about Fern's AsyncAPI extensions for generating higher-quality SDKs
 ---
 
-Fern supports a variety of AsyncAPI extensions that enhance your API specification and generate higher-quality SDKs. You can apply these extensions in two ways: by overlaying them in separate override files or by embedding them directly in your AsyncAPI specification.
+Fern supports a variety of AsyncAPI extensions that enhance your API specification and generate higher-quality SDKs. 
+
+You can apply these extensions in two ways: by overlaying them in separate override files or by embedding them directly in your AsyncAPI specification. See [Overrides](/api-definitions/overview/overrides) for more information. 
 
 ## Available extensions
 
@@ -22,6 +24,4 @@ The table below shows all available extensions and links to detailed documentati
 
 <Note title="Request a new extension">
     If there's an extension you want that doesn't already exist, file an [issue](https://github.com/fern-api/fern/issues/new) to start a discussion about it.
-</Note>
-
-<Markdown src="/snippets/overlay-embed-extensions.mdx" />
+</Note>

fern/products/api-def/asyncapi-pages/overrides.mdx

@@ -5,6 +5,8 @@ description: Learn about Fern's gRPC extensions for generating higher-quality SD
 
 Fern supports a variety of gRPC extensions that enhance your API specification and generate higher-quality SDKs.
 
+You can apply these extensions in two ways: by overlaying them in separate override files or by embedding them directly in your gRPC specification. See [Overrides](/api-definitions/overview/overrides) for more information. 
+
 ## Available extensions
 
 The table below shows all available extensions and links to detailed documentation for each one.