Skip to content

Replace dead rancher.com/docs links - #3068

Merged
ctauchen merged 2 commits into
tigera:mainfrom
ctauchen:fix-rancher-doc-links
Oct 9, 2026
Merged

ctauchen merged 2 commits into
tigera:mainfrom
ctauchen:fix-rancher-doc-links

Conversation

@ctauchen

@ctauchen ctauchen commented Oct 9, 2026 •

Copy link
Copy Markdown
Collaborator

The legacy rancher.com/docs paths return 502, which fails the build link check on the K3s and Rancher install pages.

This change points K3s links to docs.k3s.io and RKE links to rke.docs.rancher.com in all published Calico Open Source and Calico Enterprise versions. The RKE2 install page now links to the RKE2 quick start instead of RKE1 documentation. Each new URL and anchor was checked and resolves.

Representative pages:

The legacy rancher.com/docs paths now return 502 and fail the
build link check. Point K3s links to docs.k3s.io and RKE links to
rke.docs.rancher.com, keeping the same anchors.
@ctauchen
ctauchen requested a review from a team as a code owner October 9, 2026 15:02
Copilot AI balanced review requested due to automatic review settings October 9, 2026 15:02
@netlify

netlify Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 2751945
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6ac9038a60060400075027a6
😎 Deploy Preview https://deploy-preview-3068--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 2751945
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6ac9038a31a91800082e178a
😎 Deploy Preview https://deploy-preview-3068--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 81 (🔴 down 10 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The six RKE2 pages incorrectly direct users to RKE1 documentation rather than the corresponding RKE2 documentation.

6 open findings
What changed in this PR

Updates dead legacy Rancher documentation links across current and published Calico Open Source and Enterprise documentation.

Changes:

  • Replaces legacy RKE links with rke.docs.rancher.com.
  • Replaces legacy K3s links with docs.k3s.io.
  • Applies updates consistently across current and versioned documentation.
File Description
calico/​getting-started/​kubernetes/​windows-calico/​rancher.mdx Updates RKE Windows links.
calico/​getting-started/​kubernetes/​rancher.mdx Updates RKE installation links.
calico/​getting-started/​kubernetes/​k3s/​quickstart.mdx Updates K3s requirements link.
calico/​getting-started/​kubernetes/​k3s/​multi-node-install.mdx Updates K3s installation links.
calico-enterprise/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates Enterprise Windows RKE links.
calico-enterprise/​getting-started/​install-on-clusters/​rke2.mdx Replaces a legacy link on the RKE2 page.
calico-enterprise/​getting-started/​install-on-clusters/​rancher.mdx Updates Enterprise RKE links.
calico-enterprise_versioned_docs/​version-3.24-2/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico-enterprise_versioned_docs/​version-3.24-2/​getting-started/​install-on-clusters/​rke2.mdx Replaces a versioned RKE2-page link.
calico-enterprise_versioned_docs/​version-3.24-2/​getting-started/​install-on-clusters/​rancher.mdx Updates versioned RKE links.
calico-enterprise_versioned_docs/​version-3.24-1/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico-enterprise_versioned_docs/​version-3.24-1/​getting-started/​install-on-clusters/​rke2.mdx Replaces a versioned RKE2-page link.
calico-enterprise_versioned_docs/​version-3.24-1/​getting-started/​install-on-clusters/​rancher.mdx Updates versioned RKE links.
calico-enterprise_versioned_docs/​version-3.23-2/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico-enterprise_versioned_docs/​version-3.23-2/​getting-started/​install-on-clusters/​rke2.mdx Replaces a versioned RKE2-page link.
calico-enterprise_versioned_docs/​version-3.23-2/​getting-started/​install-on-clusters/​rancher.mdx Updates versioned RKE links.
calico-enterprise_versioned_docs/​version-3.22-2/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico-enterprise_versioned_docs/​version-3.22-2/​getting-started/​install-on-clusters/​rke2.mdx Replaces a versioned RKE2-page link.
calico-enterprise_versioned_docs/​version-3.22-2/​getting-started/​install-on-clusters/​rancher.mdx Updates versioned RKE links.
calico-enterprise_versioned_docs/​version-3.21-2/​getting-started/​install-on-clusters/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico-enterprise_versioned_docs/​version-3.21-2/​getting-started/​install-on-clusters/​rke2.mdx Replaces a versioned RKE2-page link.
calico-enterprise_versioned_docs/​version-3.21-2/​getting-started/​install-on-clusters/​rancher.mdx Updates versioned RKE links.
calico_versioned_docs/​version-3.33/​getting-started/​kubernetes/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico_versioned_docs/​version-3.33/​getting-started/​kubernetes/​rancher.mdx Updates versioned RKE links.
calico_versioned_docs/​version-3.33/​getting-started/​kubernetes/​k3s/​quickstart.mdx Updates versioned K3s requirements link.
calico_versioned_docs/​version-3.33/​getting-started/​kubernetes/​k3s/​multi-node-install.mdx Updates versioned K3s links.
calico_versioned_docs/​version-3.32/​getting-started/​kubernetes/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico_versioned_docs/​version-3.32/​getting-started/​kubernetes/​rancher.mdx Updates versioned RKE links.
calico_versioned_docs/​version-3.32/​getting-started/​kubernetes/​k3s/​quickstart.mdx Updates versioned K3s requirements link.
calico_versioned_docs/​version-3.32/​getting-started/​kubernetes/​k3s/​multi-node-install.mdx Updates versioned K3s links.
calico_versioned_docs/​version-3.31/​getting-started/​kubernetes/​windows-calico/​rancher.mdx Updates versioned Windows RKE links.
calico_versioned_docs/​version-3.31/​getting-started/​kubernetes/​rancher.mdx Updates versioned RKE links.
calico_versioned_docs/​version-3.31/​getting-started/​kubernetes/​k3s/​quickstart.mdx Updates versioned K3s requirements link.
calico_versioned_docs/​version-3.31/​getting-started/​kubernetes/​k3s/​multi-node-install.mdx Updates versioned K3s links.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread calico-enterprise/getting-started/install-on-clusters/rke2.mdx Outdated
The RKE2 install page linked to RKE1 documentation for cluster
setup help. Point it to the RKE2 quick start instead.
Copilot AI balanced review requested due to automatic review settings October 9, 2026 15:08

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The replacements are consistent and no targeted legacy RKE or K3s links remain.

0 open findings

6 resolved since last review

🧠 Review effort: Balanced

@ctauchen
ctauchen merged commit 7d7d67b into tigera:main Oct 9, 2026
11 checks passed
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.

2 participants