Skip to content

DOCS-3016: Remove the unpublished Calico Enterprise 3.20 and Calico Cloud 22-2 doc trees - #2937

Merged
ctauchen merged 1 commit into
tigera:mainfrom
ctauchen:DOCS-3016-remove-ce-3.20-cc-22-2
Aug 20, 2026
Merged

DOCS-3016: Remove the unpublished Calico Enterprise 3.20 and Calico Cloud 22-2 doc trees#2937
ctauchen merged 1 commit into
tigera:mainfrom
ctauchen:DOCS-3016-remove-ce-3.20-cc-22-2

Conversation

@ctauchen

Copy link
Copy Markdown
Collaborator

We publish the latest release and the two before it. Two version trees have already fallen outside that window and are no longer built, but they were still in the repo. This deletes them.

Calico Enterprise 3.20-2 left onlyIncludeVersions when 3.23.1 published, in commit 46d18e2 on 7 July 2026. It is archived at https://archive-ce-3-20.netlify.app, src/pages/archive.md already points there, and static/_redirects already sends /calico-enterprise/3.20/* to the archive site with a 301.

Calico Cloud 22-2 left onlyIncludeVersions when 23.0.0 published, in commit 11620e0 on 28 July 2026. Calico Cloud serves a single version at path '/', so it has no archive site and no redirects to change.

That makes this the disk cleanup that follows an unpublish, which is how the last few version retirements were done: 013d7d6 for Calico Open Source 3.28 and f979fd3 for Calico Cloud 22-1.

Changes:

  • Delete calico-enterprise_versioned_docs/version-3.20-2 and its sidebar, and drop 3.20-2 from calico-enterprise_versions.json.
  • Delete calico-cloud_versioned_docs/version-22-2 and its sidebar, and drop 22-2 from calico-cloud_versions.json.
  • Remove the hardcoded 3.20-2 skip in scripts/update-felix-config.sh. That script loops over calico-enterprise_versions.json, so the skip is dead code once the version is gone.
  • Correct the version lists in README.md, which were stale on all three products.

Reviewing this one is a matter of confirming nothing changed, because neither version is built today. A local yarn build succeeds and emits zero HTML pages under /calico-enterprise/3.20 and no /calico-cloud/22-2 path at all, while /calico-enterprise/3.21 still emits its full 401 pages. The two files that do remain under /calico-enterprise/3.20 in the build output are install-calico-windows.ps1 and switch-active-operator.sh, which come from static/ and are untouched by this PR.

Worth spot-checking on the preview:

  • /calico-enterprise/latest and /calico-enterprise/3.21, to confirm the remaining Enterprise versions are unaffected.
  • /calico-cloud/about, to confirm Calico Cloud is unaffected.
  • /archive, to confirm the Calico Enterprise 3.20 entry still resolves to the Netlify archive site.

The large file count is all deletions, so the Vale check will flag this PR. That is expected.

Left out on purpose:

  • Calico Open Source 3.29. It is the fourth published Calico version and should come out under the same rule, but archive-os-3-29.netlify.app does not exist yet, so removing it now would take content off the web with nowhere to send readers. It needs its own ticket once the archive branch and Netlify site are created.
  • data/feature-status.yaml keys such as 3.19 and 3.20. Those record which release line a feature reached a given status in, not which doc versions are published.
  • src/new/data/ccImageLists.js entries for v22.x. Those are keyed by Calico Cloud product version, not by doc version directory, and air-gapped users still need them.
  • Calico Enterprise 3.24-1, which is the current early preview.

There are no stale -1 early preview trees left to remove. 3.20-1 and 3.21-1 went in #2179, 3.22-1 in 4f22ad6, and 3.23-1 in b0c267b.

Issue: https://tigera.atlassian.net/browse/DOCS-3016

…loud 22-2 doc trees

We publish the latest release and the two before it. Both of these trees
have already fallen outside that window and are no longer built, but they
were still in the repo.

Calico Enterprise 3.20-2 left onlyIncludeVersions when 3.23.1 published
(46d18e2). It is archived at archive-ce-3-20.netlify.app, src/pages/archive.md
already points there, and static/_redirects already sends
/calico-enterprise/3.20/* to the archive site.

Calico Cloud 22-2 left onlyIncludeVersions when 23.0.0 published (11620e0).
Calico Cloud serves a single version at path '/', so it has no archive site
and no redirects to change.

Nothing users can reach changes, because neither version is built today.
This is the disk cleanup that follows the unpublish, matching 013d7d6 for
Calico Open Source 3.28 and f979fd3 for Calico Cloud 22-1.

Also drops the 3.20-2 skip in scripts/update-felix-config.sh, which is dead
once the version leaves calico-enterprise_versions.json, and corrects the
version lists in README.md, which were stale on all three products.

Calico Open Source 3.29 is the next candidate under the same rule but is
left in place, because archive-os-3-29.netlify.app does not exist yet and
removing it would take content off the web with nowhere to send readers.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 20, 2026 15:24
@ctauchen
ctauchen requested a review from a team as a code owner August 20, 2026 15:24

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.

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

@netlify

netlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

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

Name Link
🔨 Latest commit 0d3b10e
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6a871c4e58dcc600080829dd
😎 Deploy Preview https://deploy-preview-2937--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 Aug 20, 2026

Copy link
Copy Markdown

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 0d3b10e
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6a871c4ebcd764000842e422
😎 Deploy Preview https://deploy-preview-2937--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: 74 (🔴 down 20 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.

@ctauchen
ctauchen merged commit 322fe99 into tigera:main Aug 20, 2026
10 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