chore: fix redirects (#1192)

Author: devalog

fern/docs.yml

@@ -179,8 +179,11 @@ redirects:
   # ============================================================================
 
   # SDK Features/Capabilities redirects
+  - source: /learn/sdks/features
+    destination: /learn/sdks/overview/capabilities
+    permanent: true
   - source: /learn/sdks/features/:slug*
-    destination: /learn/sdks/capabilities/:slug*
+    destination: /learn/sdks/overview/capabilities
     permanent: true
 
   # SDK Deep Dives - specific overrides for newer destinations
@@ -201,9 +204,6 @@ redirects:
     permanent: true
 
   # SDK Package Managers redirects
-  - source: /learn/sdks/package-managers/:slug*
-    destination: /learn/sdks/guides/publish-to-package-managers/:slug*
-    permanent: true
   - source: /learn/sdks/guides/publish-to-package-managers/npm-type-script
     destination: /learn/sdks/generators/typescript/publishing
     permanent: true
@@ -225,10 +225,13 @@ redirects:
   - source: /learn/sdks/guides/publish-to-package-managers/packagist
     destination: /learn/sdks/generators/php/publishing
     permanent: true
+  - source: /learn/sdks/package-managers/:slug*
+    destination: /learn/sdks/generators/typescript/publishing
+    permanent: true
 
   # SDK Introduction redirects  
   - source: /learn/sdks/introduction/configuration
-    destination: /learn/sdks/introduction/language-support
+    destination: /learn/sdks/overview/introduction
     permanent: true
   - source: /learn/sdks/introduction/language-support
     destination: /learn/sdks/overview/introduction
@@ -272,7 +275,7 @@ redirects:
 
   # SDK Capabilities - remaining general redirects (after specific overrides above)
   - source: /learn/sdks/capabilities/idiomatic-method-names
-    destination: /learn/sdks/capabilities/method-names
+    destination: /learn/sdks/deep-dives/customize-method-names
     permanent: true
   - source: /learn/sdks/capabilities/o-auth-token-refresh
     destination: /learn/sdks/capabilities/oauth
@@ -289,6 +292,7 @@ redirects:
   - source: /learn/sdks/capabilities/merging-multiple-apis
     destination: /learn/sdks/capabilities/merging-apis
     permanent: true
+
   # General SDK capabilities pattern (will catch any not specifically overridden above)
   - source: /learn/sdks/capabilities/:slug*
     destination: /learn/sdks/overview/introduction
@@ -304,6 +308,10 @@ redirects:
   - source: /learn/sdks/guides/publish-to-package-managers/:slug*
     destination: /learn/sdks/generators/:slug*
     permanent: true
+  - source: /learn/sdks/reference/generators-yml-reference
+    destination: /learn/sdks/reference/generators-yml
+    permanent: true
+
   # General SDK guides pattern
   - source: /learn/sdks/getting-started/:slug*
     destination: /learn/sdks/overview/introduction
@@ -312,10 +320,6 @@ redirects:
     destination: /learn/sdks/overview/introduction
     permanent: true
 
-  - source: /learn/sdks/reference/generators-yml-reference
-    destination: /learn/sdks/reference/generators-yml
-    permanent: true
-
   # ============================================================================
   # DOCS REDIRECTS
   # ============================================================================
@@ -341,19 +345,19 @@ redirects:
 
   # Building and Customizing Your Docs redirects - specific cases first
   - source: /learn/docs/building-and-customizing-your-docs/navigation
-    destination: /learn/docs/navigation/overview
+    destination: /learn/docs/configuration/navigation
     permanent: true
   - source: /learn/docs/navigation/overview
     destination: /learn/docs/configuration/navigation
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/versioning
-    destination: /learn/docs/navigation/versions
+    destination: /learn/docs/configuration/versions
     permanent: true
   - source: /learn/docs/navigation/versions
     destination: /learn/docs/configuration/versions
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/announcements
-    destination: /learn/docs/navigation/announcement-banner
+    destination: /learn/docs/customization/announcement-banner
     permanent: true
   - source: /learn/docs/navigation/announcement-banner
     destination: /learn/docs/customization/announcement-banner
@@ -365,7 +369,7 @@ redirects:
     destination: /learn/docs/seo/configuring-slugs
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/hiding-content
-    destination: /learn/docs/navigation/hiding-content
+    destination: /learn/docs/customization/hiding-content
     permanent: true
   - source: /learn/docs/navigation/hiding-content
     destination: /learn/docs/customization/hiding-content
@@ -374,7 +378,7 @@ redirects:
     destination: /learn/docs/preview-publish/previewing-changes-in-a-pr
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/product-switching
-    destination: /learn/docs/navigation/products
+    destination: /learn/docs/configuration/products
     permanent: true
   - source: /learn/docs/navigation/products
     destination: /learn/docs/configuration/products
@@ -411,7 +415,7 @@ redirects:
     destination: /learn/docs/writing-content/reusable-snippets
     permanent: true
   - source: /learn/docs/content/changelog
-    destination: /learn/docs/navigation/changelogs
+    destination: /learn/docs/customization/changelogs
     permanent: true
   - source: /learn/docs/navigation/changelogs
     destination: /learn/docs/customization/changelogs
@@ -449,21 +453,21 @@ redirects:
 
   # CLI & API Reference specific redirects first
   - source: /learn/cli-api/cli-reference/get-started-with-fern-cli
-    destination: /learn/cli-reference/overview
+    destination: /learn/cli-api-reference/cli-reference/overview
     permanent: true
   - source: /learn/cli-api/cli-reference/cli-overview
-    destination: /learn/cli-reference/overview
+    destination: /learn/cli-api-reference/cli-reference/overview
     permanent: true
   - source: /learn/cli-reference/cli-overview
-    destination: /learn/cli-reference/overview
+    destination: /learn/cli-api-reference/cli-reference/overview
+    permanent: true
+  - source: /learn/cli-reference/overview
+    destination: /learn/cli-api-reference/cli-reference/overview
     permanent: true
   - source: /learn/cli-api/cli-reference/global-options
-    destination: /learn/cli-reference/options
+    destination: /learn/cli-api-reference/cli-reference/options
     permanent: true
   - source: /learn/cli-reference/get-started
-    destination: /learn/cli-reference/overview
-    permanent: true
-  - source: /learn/cli-reference/overview
     destination: /learn/cli-api-reference/cli-reference/overview
     permanent: true
   - source: /learn/cli-reference/commands
@@ -547,26 +551,16 @@ redirects:
 
   # Ask Fern specific redirects first
   - source: /learn/ai-search/customer-showcase
-    destination: /learn/ask-fern/customer-showcase
+    destination: https://buildwithfern.com/customers
     permanent: true
   - source: /learn/ai-search/overview
-    destination: /learn/ask-fern/overview
+    destination: /learn/ask-fern/getting-started/what-is-ask-fern
     permanent: true
   - source: /learn/ai-search/custom-prompting
-    destination: /learn/ask-fern/custom-prompting
+    destination: /learn/ask-fern/configuration/custom-prompting
     permanent: true
   - source: /learn/ai-search/citations
-    destination: /learn/ask-fern/citations
-    permanent: true
-  # General Ask Fern patterns
-  - source: /learn/ai-search/getting-started/:slug*
-    destination: /learn/ask-fern/:slug*
-    permanent: true
-  - source: /learn/ai-search/features/:slug*
-    destination: /learn/ask-fern/:slug*
-    permanent: true
-  - source: /learn/ai-search/:slug*
-    destination: /learn/ask-fern/:slug*
+    destination: /learn/ask-fern/features/citations
     permanent: true
   - source: /learn/ask-fern/overview
     destination: /learn/ask-fern/getting-started/what-is-ask-fern
@@ -581,6 +575,17 @@ redirects:
     destination: /learn/ask-fern/configuration/custom-prompting
     permanent: true
 
+  # General Ask Fern patterns
+  - source: /learn/ai-search/getting-started/:slug*
+    destination: /learn/ask-fern/:slug*
+    permanent: true
+  - source: /learn/ai-search/features/:slug*
+    destination: /learn/ask-fern/:slug*
+    permanent: true
+  - source: /learn/ai-search/:slug*
+    destination: /learn/ask-fern/:slug*
+    permanent: true
+
   # ============================================================================
   # API REFERENCE REDIRECTS (Fern Public API)
   # ============================================================================