diff --git a/fern/docs.yml b/fern/docs.yml
index 89016c1ed..afdd506a8 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -166,15 +166,6 @@ redirects:
   - source: /learn/api-definition/fern/api-yml-reference
     destination: /learn/api-definition/fern/api-yml/overview
     permanent: true
-  - source: /learn/docs/api-references/api-explorer
-    destination: /learn/docs/api-references/api-explorer/overview
-    permanent: true
-  - source: /learn/docs/api-references/api-playground/:slug*
-    destination: /learn/docs/api-references/api-explorer/:slug*
-    permanent: true
-  - source: /learn/docs/api-references/api-playground
-    destination: /learn/docs/api-references/api-explorer/overview
-    permanent: true
 
   # ============================================================================
   # SDK REDIRECTS
@@ -335,10 +326,6 @@ redirects:
   - source: /learn/docs/getting-started/publish-your-docs
     destination: /learn/docs/preview-publish/publishing-your-docs
     permanent: true
-  # General getting started pattern
-  # - source: /learn/docs/getting-started/:slug*
-  #   destination: /learn/docs/guides/getting-started/:slug*
-  #   permanent: true
 
   # Building and Customizing Your Docs redirects - specific cases first
   - source: /learn/docs/building-and-customizing-your-docs/navigation
@@ -366,7 +353,7 @@ redirects:
     destination: /learn/docs/navigation/products
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/custom-css-global-js
-    destination: /learn/docs/component-library/custom-components/custom-css-js
+    destination: /learn/docs/customization/custom-css-js
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/custom-domain
     destination: /learn/docs/getting-started/setting-up-your-domain
@@ -378,85 +365,40 @@ redirects:
     destination: /learn/docs/customization/search
     permanent: true
 
-  # Content Section redirects - specific cases first
   - source: /learn/docs/content/write-markdown
-    destination: /learn/docs/component-library/writing-content/markdown
-    permanent: true
-  - source: /learn/docs/content/components/button
-    destination: /learn/docs/component-library/default-components/callouts
+    destination: /learn/docs/writing-content/markdown
     permanent: true
-  - source: /learn/docs/content/components/request-snippet
-    destination: /learn/docs/component-library/default-components/endpoint-request-snippet
-    permanent: true
-  - source: /learn/docs/content/components/response-snippet
-    destination: /learn/docs/component-library/default-components/endpoint-response-snippet
-    permanent: true
-  - source: /learn/docs/content/components/schema-snippet
-    destination: /learn/docs/component-library/default-components/endpoint-schema-snippet
-    permanent: true
-  - source: /learn/docs/content/components/paramfield
-    destination: /learn/docs/component-library/default-components/parameter-fields
+  - source: /learn/docs/content/components/:slug*
+    destination: /learn/docs/writing-content/components/:slug*
     permanent: true
   - source: /learn/docs/content/custom-react-components
-    destination: /learn/docs/component-library/custom-components/custom-react-components
+    destination: /learn/docs/writing-content/custom-react-components
     permanent: true
   - source: /learn/docs/content/frontmatter
     destination: /learn/docs/customization/frontmatter
     permanent: true
   - source: /learn/docs/content/reusable-snippets
-    destination: /learn/docs/component-library/custom-components/reusable-snippets
+    destination: /learn/docs/writing-content/reusable-markdown
     permanent: true
   - source: /learn/docs/content/changelog
     destination: /learn/docs/navigation/changelogs
     permanent: true
   - source: /learn/docs/content/visual-editor
-    destination: /learn/docs/component-library/writing-content/visual-editor
-    permanent: true
-  # General content components pattern
-  - source: /learn/docs/content/components/:slug*
-    destination: /learn/docs/component-library/default-components/:slug*
-    permanent: true
-
-  # Components redirects
-  - source: /learn/docs/components/:slug*
-    destination: /learn/docs/component-library/default-components/:slug*
-    permanent: true
-
-  # API References specific page redirects - specific cases first
-  - source: /learn/docs/api-references/api-explorer/auto-populate-api-keys
-    destination: /learn/docs/api-references/autopopulate-api-key
-    permanent: true
-  - source: /learn/docs/api-references/customize-api-reference-layout
-    destination: /learn/docs/api-references/customize-api-ref
-    permanent: true
-  - source: /learn/docs/api-references/write-markdown-in-api-reference
-    destination: /learn/docs/api-references/api-ref-content
-    permanent: true
-  - source: /learn/docs/api-references/generate-webhook-reference
-    destination: /learn/docs/api-references/generate-webhook-ref
-    permanent: true
-  # General API references pattern
-  - source: /learn/docs/api-references/:slug*
-    destination: /learn/docs/guides/reference/:slug*
+    destination: /learn/docs/writing-content/visual-editor
     permanent: true
 
-# General integrations pattern
-  - source: /learn/docs/integrations/:slug*
-    destination: /learn/docs/guides/integrations/:slug*
+  - source: /learn/docs/getting-started/changelog/:slug*
+    destination: /learn/docs/changelogs/:slug*
     permanent: true
 
-  # Developer tools redirects
-  - source: /learn/docs/developer-tools/:slug*
-    destination: /learn/docs/guides/developer-tools/:slug*
+  - source: /learn/docs/api-references/api-explorer
+    destination: /learn/docs/api-references/api-explorer/overview
     permanent: true
-
-  # Writing content redirects
-  - source: /learn/docs/writing-content/visual-editor-beta
-    destination: /learn/docs/writing-content/visual-editor
+  - source: /learn/docs/api-references/api-playground/:slug*
+    destination: /learn/docs/api-references/api-explorer/:slug*
     permanent: true
-
-  - source: /learn/docs/getting-started/changelog/:slug*
-    destination: /learn/docs/changelogs/:slug*
+  - source: /learn/docs/api-references/api-playground
+    destination: /learn/docs/api-references/api-explorer/overview
     permanent: true
 
   # ============================================================================