From ff3e3734e839e2d4e2cb170f578419a6778e7598 Mon Sep 17 00:00:00 2001
From: Lukas Wuttke <lukas@tracebloc.io>
Date: Wed, 8 Apr 2026 16:31:05 +0200
Subject: [PATCH] fix: add 41 redirects for old docs URLs causing GSC 404s
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Google Search Console shows 45 docs.tracebloc.io pages returning 404,
being re-crawled daily and wasting crawl budget. These are old URLs
from before the docs restructure.

Adds Mintlify redirects mapping every old URL to its current equivalent:
- /getting-started/* → /overview/ or /environment-setup/
- /collaboration/* → /join-use-case/
- /experiment/* → /join-use-case/
- /training-parameters/* → /join-use-case/hyperparameters
- /training-guide/* → /join-use-case/start-training
- /model-requirements/* → /tools-help/ or /create-use-case/
- /FAQ/* → /tools-help/faqs
- /key-terms/* → /tools-help/key-terms
- /client-setup/* → /environment-setup/
- /tags/* → /overview/tracebloc (tag system removed)
- /blog/* → tracebloc.io/blog (blog moved to main site)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs.json | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/docs.json b/docs.json
index 0fd058d..c948261 100644
--- a/docs.json
+++ b/docs.json
@@ -130,6 +130,49 @@
       "measurementId": "G-9CS3JNFFRJ"
     }
   },
+  "redirects": [
+    { "source": "/getting-started/overview", "destination": "/overview/tracebloc" },
+    { "source": "/getting-started/quickstart", "destination": "/environment-setup/setup-guide" },
+    { "source": "/getting-started/core-concepts", "destination": "/tools-help/key-terms" },
+    { "source": "/getting-started/pricing", "destination": "https://tracebloc.io/#pricing" },
+    { "source": "/environment-setup/deployment-guide", "destination": "/environment-setup/setup-guide" },
+    { "source": "/environment-setup/local-deployment-guide-macos", "destination": "/environment-setup/setup-guide" },
+    { "source": "/environment-setup/local-deployment-guide-linux", "destination": "/environment-setup/setup-guide" },
+    { "source": "/environment-setup/azure-deployment-guide", "destination": "/environment-setup/eks-client-deployment-guide" },
+    { "source": "/environment-setup/eks-deployment-guide", "destination": "/environment-setup/eks-client-deployment-guide" },
+    { "source": "/environment-setup/architecture", "destination": "/environment-setup/configuration" },
+    { "source": "/environment-setup/setup_eks.sh", "destination": "/environment-setup/eks-client-deployment-guide" },
+    { "source": "/join-use-case/tracebloc-package", "destination": "/tools-help/tracebloc-package" },
+    { "source": "/join-use-case/model-optimisation.md", "destination": "/join-use-case/model-optimization" },
+    { "source": "/join-use-case/join-use-case/model-optimisation.md", "destination": "/join-use-case/model-optimization" },
+    { "source": "/tracebloc-package/user-linkModelDataset", "destination": "/tools-help/tracebloc-package" },
+    { "source": "/experiment/details", "destination": "/join-use-case/explore-use-case" },
+    { "source": "/experiment/exp-guide", "destination": "/join-use-case/start-training" },
+    { "source": "/collaboration/collaboration-overview", "destination": "/join-use-case/overview" },
+    { "source": "/collaboration/dataset-guide", "destination": "/create-use-case/prepare-dataset" },
+    { "source": "/collaboration/leaderboard", "destination": "/join-use-case/model-evaluation" },
+    { "source": "/collaboration/prizes", "destination": "/join-use-case/overview" },
+    { "source": "/create-use-case/set-evaluation", "destination": "/create-use-case/evaluate-models" },
+    { "source": "/client-setup/setup-requirements", "destination": "/environment-setup/setup-guide" },
+    { "source": "/training-guide/jupyter-notebook", "destination": "/join-use-case/start-training" },
+    { "source": "/model-requirements/api-supported", "destination": "/tools-help/tracebloc-package" },
+    { "source": "/model-requirements/model-zoo", "destination": "/create-use-case/templates" },
+    { "source": "/FAQ/Collaboration", "destination": "/tools-help/faqs" },
+    { "source": "/FAQ/General", "destination": "/tools-help/faqs" },
+    { "source": "/key-terms/notifications", "destination": "/tools-help/key-terms" },
+    { "source": "/key-terms/archive", "destination": "/tools-help/key-terms" },
+    { "source": "/training-parameters/TrainingPlan", "destination": "/join-use-case/hyperparameters" },
+    { "source": "/training-parameters/TrainingPlan-hyperparameter", "destination": "/join-use-case/hyperparameters" },
+    { "source": "/training-parameters/TrainingPlan-datasetparameter", "destination": "/create-use-case/prepare-dataset" },
+    { "source": "/training-parameters/TrainingPlan-llmparameter", "destination": "/join-use-case/hyperparameters" },
+    { "source": "/training-parameters/TrainingPlan-trainingdescription", "destination": "/join-use-case/start-training" },
+    { "source": "/training-parameters/TrainingPlan-notsupported", "destination": "/tools-help/faqs" },
+    { "source": "/markdown-page", "destination": "/overview/tracebloc" },
+    { "source": "/tags/:slug*", "destination": "/overview/tracebloc" },
+    { "source": "/blog/authors", "destination": "https://tracebloc.io/blog" },
+    { "source": "/blog/archive", "destination": "https://tracebloc.io/blog" },
+    { "source": "/tracebloc-package", "destination": "/tools-help/tracebloc-package" }
+  ],
   "seo": {
     "indexHiddenPages": false
   },