Skip to content

[DOC-14680][AI] Point cloud deployment links at the current Operator install page - #4163

Draft
TimLFletcher wants to merge 1 commit into
release/8.0from
DOC-14680
Draft

[DOC-14680][AI] Point cloud deployment links at the current Operator install page#4163
TimLFletcher wants to merge 1 commit into
release/8.0from
DOC-14680

Conversation

@TimLFletcher

@TimLFletcher TimLFletcher commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Fixes DOC-14680.

What changed

modules/cloud/pages/couchbase-cloud-deployment.adoc, lines 58, 140 and 220.

-* xref:operator:ROOT:install-eks.adoc[Kubernetes (EKS and Unmanaged)]
-* xref:operator:ROOT:install-aks.adoc[Kubernetes (AKS and Unmanaged)]
-* xref:operator:ROOT:install-gke.adoc[Kubernetes (GKE and Unmanaged)]
+* xref:operator:ROOT:install-kubernetes.adoc[Kubernetes (EKS and Unmanaged)]
+* xref:operator:ROOT:install-kubernetes.adoc[Kubernetes (AKS and Unmanaged)]
+* xref:operator:ROOT:install-kubernetes.adoc[Kubernetes (GKE and Unmanaged)]

Link text is unchanged: it still describes the destination accurately.

The successor the ticket could not find

The ticket says "pages are gone, no obvious 1:1 successor found". There isn't a 1:1 successor, which is why. The three per-cloud pages were consolidated 3:1 into install-kubernetes.adoc, whose Certified Kubernetes Platforms section (docs-operator release/2.10, line 31) lists exactly:

  • Amazon Elastic Kubernetes Service (EKS)
  • Google Kubernetes Engine (GKE)
  • Microsoft Azure Kubernetes Service (AKS)

The sibling install-openshift.adoc links in the same three lists were never broken and still resolve, which supports the reading that install-<cloud> was merged while install-openshift was kept.

Other branches

The same three broken xrefs are present on release/8.5 and release/7.6. This PR covers release/8.0 only. The ticket does not say which branches to fix.

Verification

A single-component build cannot resolve operator: xrefs at all, so the Antora build proves nothing about these targets either way. They were checked directly against the workspace:

OK   ...:58   operator:ROOT:install-kubernetes.adoc -> docs-operator
OK   ...:140  operator:ROOT:install-kubernetes.adoc -> docs-operator
OK   ...:220  operator:ROOT:install-kubernetes.adoc -> docs-operator
PASS: all 8 cross-component xref target(s) resolve

Run against the pre-change file, the same check reports the three original targets as MISS, reproducing the reported breakage.

PASS[docs-server @ DOC-14680 vs baseline release/8.0]: no new build diagnostics.

🤖 Generated with Claude Code

…install page

couchbase-cloud-deployment.adoc linked to operator:ROOT:install-gke.adoc,
install-eks.adoc and install-aks.adoc. All three were removed from
docs-operator by the K8S-1268 restructure.

They were consolidated into install-kubernetes.adoc, whose Certified
Kubernetes Platforms section lists EKS, GKE and AKS. All three links now
point there. Link text is unchanged, since it still describes the
destination.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant