DOCS-2944: Archive the Calico Open Source 3.29 docs - #2957
Merged
Conversation
Calico Open Source 3.32 shipped, so 3.29 falls outside the N-2 window and moves to its archive site at archive-os-3-29.netlify.app. - Drop 3.29 from the calico docs plugin so docs.tigera.io stops building it. - Redirect /calico/3.29/* to the archive site. - Point the 3.29 entry on the documentation archive page at the archive site. The 3.29 content stays in the repo for now. Deleting the tree is the follow-up step. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for calico-docs-preview-next ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
✅ Deploy Preview succeeded!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR unpublishes Calico Open Source v3.29 from the main docs site (outside the N-2 support window) by removing it from the Docusaurus build and routing requests to the dedicated archive site, while keeping the 3.29 content in-repo for a later cleanup.
Changes:
- Removes 3.29 from the Calico OSS docs plugin
onlyIncludeVersionslist and itsversionsmap entry so it no longer builds/publishes. - Adds a Netlify 301 redirect rule sending
/calico/3.29/*traffic toarchive-os-3-29.netlify.app. - Updates the docs archive page to link the 3.29 entry to the archive site instead of
docs.tigera.io.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| static/_redirects | Adds a 301 redirect for /calico/3.29/* to the 3.29 archive site. |
| src/pages/archive.md | Updates the 3.29 archive bullet to point at the archive Netlify site. |
| docusaurus.config.js | Removes 3.29 from the Calico OSS docs versions configuration so it is no longer built/published. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
The previous commit stopped building 3.29 and redirected its paths to archive-os-3-29.netlify.app, so the content in the repo is no longer reachable. This removes it from disk. - Delete calico_versioned_docs/version-3.29 and its sidebars file, and drop the entry from calico_versions.json. - Drop the 3.29 skip in scripts/update-felix-config.sh, which is dead once the version leaves calico_versions.json. - Correct the two stale version lists in README.md. Nothing users can reach changes. The 3.29 content stays available on the archive branch and its Netlify site. This is the step DOCS-3016 (322fe99) deferred, where 3.29 was held back because the archive site did not exist yet. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ctauchen
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Calico Open Source 3.32 shipped, so 3.29 falls outside the N-2 support window. This retires it: docs.tigera.io stops serving it, its traffic goes to the archive site, and the content comes off disk.
The archive branch and Netlify site are already in place and serving: https://archive-os-3-29.netlify.app/calico/3.29/about
That site returns 200, sends x-robots-tag: noindex,nofollow, and its robots.txt disallows everything, so the archived pages cannot outrank current versions in search.
Two commits, in the order they have to happen.
Unpublish from docs.tigera.io:
Delete the content, now that nothing reaches it:
This is the step DOCS-3016 deferred. That change retired Calico Enterprise 3.20-2 and Calico Cloud 22-2 but deliberately left 3.29 alone, because the archive site did not exist yet and removing it would have taken content off the web with nowhere to send readers. It exists now.
Verified with yarn build at each commit. The build treats broken links as errors, so it passing confirms nothing in the remaining doc sets links into 3.29. After the first commit the 3.29 route went from 309 built pages to none and the version dropdown stopped offering it; after the second, 3.30, 3.31, and latest still build at full page count. make show_current_branches now lists 3.30 through 3.32, which is what the corrected README claims. There are no cross-version MDX imports into the deleted directory.
To review on the deploy preview:
Redirects do run on the deploy preview, so the 3.29 rule is already verifiable there. Checked against https://deploy-preview-2957--tigera.netlify.app: