Skip to content

docs: remove dynamic variable from frozen release notes and upgrade guides#2192

Merged
cert-manager-prow[bot] merged 1 commit into
cert-manager:masterfrom
wallrj-cyberark:fix-2105-var-in-frozen-docs
Jul 1, 2026
Merged

docs: remove dynamic variable from frozen release notes and upgrade guides#2192
cert-manager-prow[bot] merged 1 commit into
cert-manager:masterfrom
wallrj-cyberark:fix-2105-var-in-frozen-docs

Conversation

@wallrj-cyberark

@wallrj-cyberark wallrj-cyberark commented Jul 1, 2026

Copy link
Copy Markdown
Member

Preview:

Problem

The [[VAR::cert_manager_latest_version]] template variable resolves to the
current latest cert-manager version (presently v1.20.3). When this variable
appears inside frozen release notes and upgrade guides for older releases, it
produces confusing instructions such as:

When upgrading to cert-manager 1.19, use the latest patch version: v1.20.3.

Reported in #2105 (and originally noted in #1433).

Fix

Replace the dynamic variable with static text that does not embed a specific
patch version, so the wording stays accurate without requiring future updates:

  • upgrading-1.18-1.19.md: heading and body now say "use the latest patch version of cert-manager 1.19"
  • release-notes-1.16.md: helm template example uses v1.16.x
  • release-notes-1.19.md: body now says "use the latest patch version of cert-manager 1.19"

Testing

Verified with grep that no [[VAR::cert_manager_latest_version]] references
remain in content/docs/releases/.

…uides

The [[VAR::cert_manager_latest_version]] template variable resolves to the
current latest version of cert-manager. When used inside frozen release notes
and upgrade guides for older releases, this produces confusing instructions
such as "When upgrading to cert-manager 1.19, use the latest patch version:
v1.20.3."

Replace the variable with static text:
- upgrading-1.18-1.19.md: "use the latest patch version of cert-manager 1.19"
- release-notes-1.16.md: use `v1.16.x` in the helm template command example
- release-notes-1.19.md: "use the latest patch version of cert-manager 1.19"

Fixes: cert-manager#2105
Signed-off-by: Richard Wall <richard.wall@cyberark.com>
@cert-manager-prow cert-manager-prow Bot added dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jul 1, 2026
@netlify

netlify Bot commented Jul 1, 2026

Copy link
Copy Markdown

Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 7d42914
🔍 Latest deploy log https://app.netlify.com/projects/cert-manager/deploys/6a44fb458690c50008c9f156
😎 Deploy Preview https://deploy-preview-2192--cert-manager.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@wallrj-cyberark

Copy link
Copy Markdown
Member Author

@joebowbeer — this should fix the issue you reported. Please take a look at the preview links in the description and let us know if the wording looks right to you.

@joebowbeer joebowbeer left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM (wording)

@wallrj-cyberark wallrj-cyberark added approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged. labels Jul 1, 2026
@cert-manager-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

Approval requirements bypassed by manually added approval.

This pull-request has been approved by: joebowbeer

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@cert-manager-prow cert-manager-prow Bot merged commit 5db5a9d into cert-manager:master Jul 1, 2026
7 checks passed
@wallrj-cyberark wallrj-cyberark deleted the fix-2105-var-in-frozen-docs branch July 1, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. lgtm Indicates that a PR is ready to be merged. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants