DOCS-3009: Populate the deprecated and removed features sections - #2929
Open
ctauchen wants to merge 2 commits into
Open
DOCS-3009: Populate the deprecated and removed features sections#2929ctauchen wants to merge 2 commits into
ctauchen wants to merge 2 commits into
Conversation
Add a Deprecated and removed features section to the Calico Open Source 3.30 and 3.31 release notes, and complete the section in 3.32. Each section states what is deprecated, and carries a table covering a rolling window of three releases. The two deprecations are the aggregation API server, deprecated in 3.32, and FIPS mode, deprecated in 3.30. FIPS mode is deprecated in three releases and had never appeared in any release notes. Rename "aggregated API server" to "aggregation API server" in the 3.32 release notes, so the page uses one name. 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
Adds consistent “Deprecated and removed features” coverage to Calico OSS release notes across versions 3.30–3.32, including a rolling 3-release status table and updated wording to use “aggregation API server” consistently in 3.32.
Changes:
- Add a “Deprecated and removed features” section to 3.30 and 3.31 release notes with a 3-release rolling window table (covering FIPS mode).
- Expand the existing 3.32 section with explanatory text, bullets, and a 3-release rolling window table (covering aggregation API server and FIPS mode).
- Rename “aggregated API server” → “aggregation API server” within the 3.32 release notes content for consistency.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| calico_versioned_docs/version-3.32/release-notes/index.mdx | Standardizes “aggregation API server” terminology and expands the deprecated/removed section with bullets + a 3.30–3.32 status table. |
| calico_versioned_docs/version-3.31/release-notes/index.mdx | Introduces deprecated/removed section and a 3.29–3.31 rolling status table for FIPS mode. |
| calico_versioned_docs/version-3.30/release-notes/index.mdx | Introduces deprecated/removed section and a 3.28–3.30 rolling status table for FIPS mode. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
A table that covers three releases cannot show a status change that happened in its first column. FIPS mode was deprecated in 3.30, so the 3.32 table shows it as deprecated in every column, which reads the same as a feature deprecated years earlier. State the deprecation release in the bullet for the 3.31 and 3.32 release notes. The 3.30 bullet stays in the present tense, because 3.30 is the release where the deprecation happened. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.
The release notes record a deprecation once, in the release it happens, and often not at all. FIPS mode is deprecated in 3.30, 3.31, and 3.32 and appears in no release notes. This adds a Deprecated and removed features section to the 3.30 and 3.31 release notes, completes the section in 3.32, and gives each one a table covering a rolling window of three releases.
Changes:
Deploy preview: https://deploy-preview-2929--tigera.netlify.app/calico/latest/release-notes
DOCS-3009: https://tigera.atlassian.net/browse/DOCS-3009