From f5e0c8531a51f0570060b51f685c2ab8be01fb6e Mon Sep 17 00:00:00 2001
From: Dax Raad <d@ironbay.co>
Date: Tue, 27 Oct 2026 14:00:22 -0400
Subject: [PATCH] fix(console): link to v2 docs

---
 .../app/src/shell/commands/desktop-menu.ts    |  2 +-
 packages/console/app/src/component/footer.tsx |  2 +-
 packages/console/app/src/routes/[...404].tsx  |  2 +-
 .../console/app/src/routes/download/index.tsx | 20 +++++++++----------
 packages/console/app/src/routes/index.tsx     | 12 +++++------
 5 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/packages/app/src/shell/commands/desktop-menu.ts b/packages/app/src/shell/commands/desktop-menu.ts
index d519eeaf975a..d256a42bec07 100644
--- a/packages/app/src/shell/commands/desktop-menu.ts
+++ b/packages/app/src/shell/commands/desktop-menu.ts
@@ -272,7 +272,7 @@ export const DESKTOP_MENU: DesktopMenu[] = [
     id: "help",
     labelKey: "desktop.menu.help",
     items: [
-      { type: "item", labelKey: "desktop.menu.documentation", href: "https://opencode.ai/docs" },
+      { type: "item", labelKey: "desktop.menu.documentation", href: "https://opencode.ai/v2/docs" },
       { type: "item", labelKey: "desktop.menu.supportForum", href: "https://discord.com/invite/opencode" },
       { type: "item", labelKey: "desktop.menu.exportLogs", command: "logs.export" },
       { type: "separator" },
diff --git a/packages/console/app/src/component/footer.tsx b/packages/console/app/src/component/footer.tsx
index 0ea370ac7895..f01373299d32 100644
--- a/packages/console/app/src/component/footer.tsx
+++ b/packages/console/app/src/component/footer.tsx
@@ -32,7 +32,7 @@ export function Footer() {
         </a>
       </div>
       <div data-slot="cell">
-        <a href={language.route("/docs")}>{i18n.t("footer.docs")}</a>
+        <a href="/v2/docs">{i18n.t("footer.docs")}</a>
       </div>
       <div data-slot="cell">
         <a href={language.route("/changelog")}>{i18n.t("footer.changelog")}</a>
diff --git a/packages/console/app/src/routes/[...404].tsx b/packages/console/app/src/routes/[...404].tsx
index e20ec36fd669..c51728090d33 100644
--- a/packages/console/app/src/routes/[...404].tsx
+++ b/packages/console/app/src/routes/[...404].tsx
@@ -27,7 +27,7 @@ export default function NotFound() {
             <a href={language.route("/")}>{i18n.t("notFound.home")}</a>
           </div>
           <div data-slot="action">
-            <a href={language.route("/docs")}>{i18n.t("notFound.docs")}</a>
+            <a href="/v2/docs">{i18n.t("notFound.docs")}</a>
           </div>
           <div data-slot="action">
             <a href="https://github.com/anomalyco/opencode">{i18n.t("notFound.github")}</a>
diff --git a/packages/console/app/src/routes/download/index.tsx b/packages/console/app/src/routes/download/index.tsx
index 89d50eea5edd..a24b79de987f 100644
--- a/packages/console/app/src/routes/download/index.tsx
+++ b/packages/console/app/src/routes/download/index.tsx
@@ -259,7 +259,7 @@ export default function Download() {
                   </span>
                   <span>VS Code</span>
                 </div>
-                <a href={language.route("/docs/ide/")} data-component="action-button">
+                <a href="/v2/docs/cli/acp/" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -283,7 +283,7 @@ export default function Download() {
                   </span>
                   <span>Cursor</span>
                 </div>
-                <a href={language.route("/docs/ide/")} data-component="action-button">
+                <a href="/v2/docs/cli/acp/" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -300,7 +300,7 @@ export default function Download() {
                   </span>
                   <span>Zed</span>
                 </div>
-                <a href={language.route("/docs/ide/")} data-component="action-button">
+                <a href="/v2/docs/cli/acp/" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -317,7 +317,7 @@ export default function Download() {
                   </span>
                   <span>Windsurf</span>
                 </div>
-                <a href={language.route("/docs/ide/")} data-component="action-button">
+                <a href="/v2/docs/cli/acp/" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -334,7 +334,7 @@ export default function Download() {
                   </span>
                   <span>VSCodium</span>
                 </div>
-                <a href={language.route("/docs/ide/")} data-component="action-button">
+                <a href="/v2/docs/cli/acp/" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -358,7 +358,7 @@ export default function Download() {
                   </span>
                   <span>GitHub</span>
                 </div>
-                <a href={language.route("/docs/github/")} data-component="action-button">
+                <a href="/v2/docs/cli/commands/#ci" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -375,7 +375,7 @@ export default function Download() {
                   </span>
                   <span>GitLab</span>
                 </div>
-                <a href={language.route("/docs/gitlab/")} data-component="action-button">
+                <a href="/v2/docs/cli/commands/#ci" data-component="action-button">
                   {i18n.t("download.action.install")}
                 </a>
               </div>
@@ -393,13 +393,13 @@ export default function Download() {
             </li>
             <li>
               <Faq question={i18n.t("home.faq.q2")}>
-                {i18n.t("home.faq.a2.before")} <a href={language.route("/docs")}>{i18n.t("home.faq.a2.link")}</a>.
+                {i18n.t("home.faq.a2.before")} <a href="/v2/docs">{i18n.t("home.faq.a2.link")}</a>.
               </Faq>
             </li>
             <li>
               <Faq question={i18n.t("home.faq.q3")}>
                 {i18n.t("download.faq.a3.beforeLocal")}{" "}
-                <a href={language.route("/docs/providers/#lm-studio")} target="_blank">
+                <a href="/v2/docs/models/#local" target="_blank">
                   {i18n.t("download.faq.a3.localLink")}
                 </a>{" "}
                 {i18n.t("download.faq.a3.afterLocal.beforeZen")}{" "}
@@ -411,7 +411,7 @@ export default function Download() {
               <Faq question={i18n.t("home.faq.q5")}>
                 {i18n.t("home.faq.a5.beforeDesktop")}{" "}
                 <a href={language.route("/download")}>{i18n.t("home.faq.a5.desktop")}</a> {i18n.t("home.faq.a5.and")}{" "}
-                <a href={language.route("/docs/cli/#web")}>{i18n.t("home.faq.a5.web")}</a>!
+                <a href="/v2/docs/cli/web/">{i18n.t("home.faq.a5.web")}</a>!
               </Faq>
             </li>
             <li>
diff --git a/packages/console/app/src/routes/index.tsx b/packages/console/app/src/routes/index.tsx
index 317bf52804e3..39305e37659b 100644
--- a/packages/console/app/src/routes/index.tsx
+++ b/packages/console/app/src/routes/index.tsx
@@ -215,7 +215,7 @@ export default function Home() {
                 </div>
               </li>
             </ul>
-            <a href={language.route("/docs")}>
+            <a href="/v2/docs">
               <span>{i18n.t("home.what.readDocs")} </span>
               <svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                 <path
@@ -655,7 +655,7 @@ export default function Home() {
 
                 <p>
                   {i18n.t("home.privacy.body")} {i18n.t("home.privacy.learnMore")}{" "}
-                  <a href={language.route("/docs/enterprise/")}>{i18n.t("home.privacy.link")}</a>.
+                  <a href="/v2/docs/policies/">{i18n.t("home.privacy.link")}</a>.
                 </p>
               </div>
             </div>
@@ -671,7 +671,7 @@ export default function Home() {
               </li>
               <li>
                 <Faq question={i18n.t("home.faq.q2")}>
-                  {i18n.t("home.faq.a2.before")} <a href={language.route("/docs")}>{i18n.t("home.faq.a2.link")}</a>.
+                  {i18n.t("home.faq.a2.before")} <a href="/v2/docs">{i18n.t("home.faq.a2.link")}</a>.
                 </Faq>
               </li>
               <li>
@@ -679,7 +679,7 @@ export default function Home() {
                   {i18n.t("home.faq.a3.p1")} {i18n.t("home.faq.a3.p2.beforeZen")}{" "}
                   <A href={language.route("/zen")}>{i18n.t("nav.zen")}</A>
                   {i18n.t("home.faq.a3.p2.afterZen")} {i18n.t("home.faq.a3.p3")} {i18n.t("home.faq.a3.p4.beforeLocal")}{" "}
-                  <a href={language.route("/docs/providers/#lm-studio")} target="_blank">
+                  <a href="/v2/docs/models/#local" target="_blank">
                     {i18n.t("home.faq.a3.p4.localLink")}
                   </a>
                   .
@@ -688,14 +688,14 @@ export default function Home() {
               <li>
                 <Faq question={i18n.t("home.faq.q4")}>
                   {i18n.t("home.faq.a4.p1")}{" "}
-                  <a href={language.route("/docs/providers/#directory")}>{i18n.t("common.learnMore")}</a>.
+                  <a href="/v2/docs/providers/">{i18n.t("common.learnMore")}</a>.
                 </Faq>
               </li>
               <li>
                 <Faq question={i18n.t("home.faq.q5")}>
                   {i18n.t("home.faq.a5.beforeDesktop")}{" "}
                   <a href={language.route("/download")}>{i18n.t("home.faq.a5.desktop")}</a> {i18n.t("home.faq.a5.and")}{" "}
-                  <a href={language.route("/docs/web")}>{i18n.t("home.faq.a5.web")}</a>!
+                  <a href="/v2/docs/cli/web/">{i18n.t("home.faq.a5.web")}</a>!
                 </Faq>
               </li>
               <li>