From 198ed08a385a983d2f31071e05e846aa80b57728 Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Wed, 18 Mar 2026 00:13:18 -0700
Subject: [PATCH] docs: fix redirect chains and disambiguate duplicate titles

Redirects:
- /cron now goes directly to /automation/cron-jobs (was chaining via /cron-jobs)
- /model and /model/ now go directly to /concepts/models (was chaining via /models)

Duplicate titles disambiguated (6 of 7 - Logging is orphaned):
- Health Checks (macOS), Skills (macOS), Voice Wake (macOS), WebChat (macOS)
- General Troubleshooting (help/ vs gateway/)
- Provider Directory (providers/index vs concepts/model-providers)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 docs/docs.json                  | 6 +++---
 docs/help/troubleshooting.md    | 2 +-
 docs/platforms/mac/health.md    | 2 +-
 docs/platforms/mac/skills.md    | 2 +-
 docs/platforms/mac/voicewake.md | 2 +-
 docs/platforms/mac/webchat.md   | 2 +-
 docs/providers/index.md         | 2 +-
 7 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/docs.json b/docs/docs.json
index 3a79d609100..5ee53ed6008 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -65,7 +65,7 @@
     },
     {
       "source": "/cron",
-      "destination": "/cron-jobs"
+      "destination": "/automation/cron-jobs"
     },
     {
       "source": "/minimax",
@@ -513,11 +513,11 @@
     },
     {
       "source": "/model",
-      "destination": "/models"
+      "destination": "/concepts/models"
     },
     {
       "source": "/model/",
-      "destination": "/models"
+      "destination": "/concepts/models"
     },
     {
       "source": "/models",
diff --git a/docs/help/troubleshooting.md b/docs/help/troubleshooting.md
index 1660100ba8c..63cfacbee50 100644
--- a/docs/help/troubleshooting.md
+++ b/docs/help/troubleshooting.md
@@ -3,7 +3,7 @@ summary: "Symptom first troubleshooting hub for OpenClaw"
 read_when:
   - OpenClaw is not working and you need the fastest path to a fix
   - You want a triage flow before diving into deep runbooks
-title: "Troubleshooting"
+title: "General Troubleshooting"
 ---
 
 # Troubleshooting
diff --git a/docs/platforms/mac/health.md b/docs/platforms/mac/health.md
index 8115dd4c250..7cda23e3221 100644
--- a/docs/platforms/mac/health.md
+++ b/docs/platforms/mac/health.md
@@ -2,7 +2,7 @@
 summary: "How the macOS app reports gateway/Baileys health states"
 read_when:
   - Debugging mac app health indicators
-title: "Health Checks"
+title: "Health Checks (macOS)"
 ---
 
 # Health Checks on macOS
diff --git a/docs/platforms/mac/skills.md b/docs/platforms/mac/skills.md
index fc1e6c6af5f..2c2b5d95924 100644
--- a/docs/platforms/mac/skills.md
+++ b/docs/platforms/mac/skills.md
@@ -3,7 +3,7 @@ summary: "macOS Skills settings UI and gateway-backed status"
 read_when:
   - Updating the macOS Skills settings UI
   - Changing skills gating or install behavior
-title: "Skills"
+title: "Skills (macOS)"
 ---
 
 # Skills (macOS)
diff --git a/docs/platforms/mac/voicewake.md b/docs/platforms/mac/voicewake.md
index 1830acb35a4..c7cacd4c5dd 100644
--- a/docs/platforms/mac/voicewake.md
+++ b/docs/platforms/mac/voicewake.md
@@ -2,7 +2,7 @@
 summary: "Voice wake and push-to-talk modes plus routing details in the mac app"
 read_when:
   - Working on voice wake or PTT pathways
-title: "Voice Wake"
+title: "Voice Wake (macOS)"
 ---
 
 # Voice Wake & Push-to-Talk
diff --git a/docs/platforms/mac/webchat.md b/docs/platforms/mac/webchat.md
index 11b500a8596..6bc27203fae 100644
--- a/docs/platforms/mac/webchat.md
+++ b/docs/platforms/mac/webchat.md
@@ -2,7 +2,7 @@
 summary: "How the mac app embeds the gateway WebChat and how to debug it"
 read_when:
   - Debugging mac WebChat view or loopback port
-title: "WebChat"
+title: "WebChat (macOS)"
 ---
 
 # WebChat (macOS app)
diff --git a/docs/providers/index.md b/docs/providers/index.md
index 82e30575bc8..7da77b34c5d 100644
--- a/docs/providers/index.md
+++ b/docs/providers/index.md
@@ -3,7 +3,7 @@ summary: "Model providers (LLMs) supported by OpenClaw"
 read_when:
   - You want to choose a model provider
   - You need a quick overview of supported LLM backends
-title: "Model Providers"
+title: "Provider Directory"
 ---
 
 # Model Providers