From cb3f49bf91e7b79f60a384ef68c787a01fd9fb5b Mon Sep 17 00:00:00 2001
From: Guanzhou Song <guanzhou.song@gmail.com>
Date: Mon, 3 Aug 2026 15:17:12 -0400
Subject: [PATCH] Point the quick start links at the quick start

#135 fixed the 404 behind this constant by adding the missing version
segment, so the links work now, but all four call sites label themselves
"Open quick start" and land on the documentation home instead - the
reader still has to find the quick start from there.

Renamed the constant for what every caller actually wants and pointed it
at the kind quick start, which is the operator's canonical local
walkthrough. Linking the page directly also skips the redirect stubs at
/documentdb-kubernetes-operator/ and .../latest/, which are meta
refreshes that only browsers follow.

No call site is left wanting the docs home, so the old name is gone
rather than kept as a second export.
---
 app/kubernetes-operator/page.tsx |  8 ++++----
 app/page.tsx                     |  4 ++--
 app/services/externalLinks.ts    | 12 ++++++++++--
 3 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/app/kubernetes-operator/page.tsx b/app/kubernetes-operator/page.tsx
index c62f7c5..a611a2e 100644
--- a/app/kubernetes-operator/page.tsx
+++ b/app/kubernetes-operator/page.tsx
@@ -1,7 +1,7 @@
 import CommandSnippet from "../components/CommandSnippet";
 import { getMetadata } from "../services/metadataService";
 import {
-  documentdbKubernetesOperatorDocsUrl,
+  documentdbKubernetesOperatorQuickStartUrl,
   documentdbKubernetesOperatorGitHubUrl,
 } from "../services/externalLinks";
 
@@ -278,7 +278,7 @@ export default function KubernetesOperatorPage() {
               </p>
               <div className="flex flex-col gap-3 sm:flex-row sm:flex-wrap">
                 <a
-                  href={documentdbKubernetesOperatorDocsUrl}
+                  href={documentdbKubernetesOperatorQuickStartUrl}
                   className="inline-flex w-full items-center justify-center rounded-md bg-emerald-500 px-6 py-3 text-sm font-semibold text-white transition-colors hover:bg-emerald-400 sm:w-auto"
                 >
                   Open quick start
@@ -465,7 +465,7 @@ export default function KubernetesOperatorPage() {
                 </p>
               </div>
               <a
-                href={documentdbKubernetesOperatorDocsUrl}
+                href={documentdbKubernetesOperatorQuickStartUrl}
                 className="inline-flex items-center justify-center rounded-md bg-emerald-500 px-5 py-3 text-sm font-semibold text-white transition-colors hover:bg-emerald-400"
               >
                 Open quick start
@@ -489,7 +489,7 @@ export default function KubernetesOperatorPage() {
           </p>
           <div className="flex flex-col justify-center gap-3 sm:flex-row sm:flex-wrap">
             <a
-              href={documentdbKubernetesOperatorDocsUrl}
+              href={documentdbKubernetesOperatorQuickStartUrl}
               className="inline-flex w-full items-center justify-center rounded-md bg-emerald-500 px-5 py-2.5 text-sm font-semibold text-white transition-colors hover:bg-emerald-400 sm:w-auto"
             >
               Open quick start
diff --git a/app/page.tsx b/app/page.tsx
index fcbb05c..b1a66c1 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -1,7 +1,7 @@
 import Image from "next/image";
 import Link from "next/link";
 import CommandSnippet from "./components/CommandSnippet";
-import { documentdbKubernetesOperatorDocsUrl } from "./services/externalLinks";
+import { documentdbKubernetesOperatorQuickStartUrl } from "./services/externalLinks";
 import { getMetadata } from "./services/metadataService";
 import { withBasePath } from "./services/sitePath";
 
@@ -549,7 +549,7 @@ export default function Home() {
                   Read operator overview
                 </Link>
                 <a
-                  href={documentdbKubernetesOperatorDocsUrl}
+                  href={documentdbKubernetesOperatorQuickStartUrl}
                   className="inline-flex items-center justify-center rounded-md border border-emerald-400/30 bg-emerald-500/10 px-6 py-3 text-sm font-semibold text-emerald-200 transition-colors hover:bg-emerald-500/20"
                 >
                   Open quick start
diff --git a/app/services/externalLinks.ts b/app/services/externalLinks.ts
index d843eed..9445af0 100644
--- a/app/services/externalLinks.ts
+++ b/app/services/externalLinks.ts
@@ -1,7 +1,15 @@
 export const documentdbDiscordUrl = 'https://discord.gg/vH7bYu524D';
 
-export const documentdbKubernetesOperatorDocsUrl =
-  'https://documentdb.io/documentdb-kubernetes-operator/latest/preview/';
+// The operator docs are versioned as /<version-or-alias>/preview/..., where
+// `preview` is the content root inside a version, not a version itself. The
+// `latest` alias keeps this following operator releases.
+//
+// Every call site labels this link "Open quick start", so it points at the
+// quick start rather than the docs home. Linking the page directly also avoids
+// the redirect stubs at /documentdb-kubernetes-operator/ and .../latest/, which
+// are meta refreshes that only browsers follow.
+export const documentdbKubernetesOperatorQuickStartUrl =
+  'https://documentdb.io/documentdb-kubernetes-operator/latest/preview/getting-started/quickstart-kind/';
 
 export const documentdbKubernetesOperatorGitHubUrl =
   'https://github.com/documentdb/documentdb-kubernetes-operator';