From 2333d5fd8129b535fa9c8da4f0004ba56a7c17f3 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 5 Jan 2026 12:20:20 +0200 Subject: [PATCH 01/17] Update release checklist with documentation PR step Add documentation PR reminder for next minor version after RC. Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/release.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/ISSUE_TEMPLATE/release.md b/.github/ISSUE_TEMPLATE/release.md index a77b52efec36b..cf180f1743bae 100644 --- a/.github/ISSUE_TEMPLATE/release.md +++ b/.github/ISSUE_TEMPLATE/release.md @@ -41,6 +41,7 @@ Target GA date: ___. __, ____ Thanks to all the folks who spent their time contributing to this release in any way possible! ``` - [ ] Monitor support channels for issues, cherry-picking bugfixes and docs fixes as appropriate during the RC period (or delegate this task to an Approver and coordinate timing) + - [ ] After creating the RC, open a documentation PR for the next minor version using [this](minor_version_update.md) template. ## GA Release Checklist From 4920e33d35f6b2b2cb2916b0c8c7ac1e5160284e Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 5 Jan 2026 12:34:40 +0200 Subject: [PATCH 02/17] Add minor version update issue template Signed-off-by: Revital Barletz --- .../ISSUE_TEMPLATE/minor_version_update.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/minor_version_update.md diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md new file mode 100644 index 0000000000000..bd350636ca347 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -0,0 +1,51 @@ +--- +name: Update Minor Version +about: Add steps when upgrading minor version +title: '' +assignees: '' +--- + +# Vx.1 to x.2 + +## Breaking Changes + +What changed that could affect your setup: +Deprecated flags / behavior removals +Deprecated fields +Other incompatible behavior or semantics changes between versions + (Add list here) + +## Custom Healthchecks Added + +New built-in health checks added in this release: +Add any new CRD health support added in this version) + +## Kustomize Upgraded + +Bundled Kustomize version bump: +Any breaking behavior +Notes about specific upstream behavior changes (e.g., namespace propagation fixes). + +## Helm Upgraded + +Bundled Helm version bump: +Any breaking behavior +Verify if your charts depend on any features tied to Helm versions.= + +## API / Security Changes + +Changes in API surface or security behavior: +Any removal of sensitive fields or changed authentication defaults + +## Behavioral Improvements / Fixes + +Operational stability and performance fixes: +Minor stability, reconciler improvements, bug fixes + +## Deprecated Items +Flags / behavior to be removed in future releases +Any deprecated config API or CLI flags + +## Upgrade Instructions +Example: CLI upgrade command + From 4138c06086782adabac1ed64f6fd53e5208d17fd Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 5 Jan 2026 15:06:51 +0200 Subject: [PATCH 03/17] Update minor_version_update.md Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index bd350636ca347..80f40b06b5b22 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -1,6 +1,6 @@ --- name: Update Minor Version -about: Add steps when upgrading minor version +about: Used by our Release Champion to add steps when upgrading minor version title: '' assignees: '' --- From bb8b30558558ec4a688507eb99b9534de4487fd7 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 5 Jan 2026 15:09:29 +0200 Subject: [PATCH 04/17] Enhance minor version update template Added sections for deprecated items and upgrade instructions. Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index 80f40b06b5b22..78bcbcf7f414e 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -43,9 +43,11 @@ Operational stability and performance fixes: Minor stability, reconciler improvements, bug fixes ## Deprecated Items + Flags / behavior to be removed in future releases Any deprecated config API or CLI flags ## Upgrade Instructions + Example: CLI upgrade command From 30209d43f2025ef6da10680e5cfa440418bd6955 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:34:41 +0200 Subject: [PATCH 05/17] Update .github/ISSUE_TEMPLATE/minor_version_update.md Co-authored-by: Peter Jiang <35584807+pjiang-dev@users.noreply.github.com> Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index 78bcbcf7f414e..5d420c41ea331 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -30,7 +30,7 @@ Notes about specific upstream behavior changes (e.g., namespace propagation fixe Bundled Helm version bump: Any breaking behavior -Verify if your charts depend on any features tied to Helm versions.= +Verify if your charts depend on any features tied to Helm versions. ## API / Security Changes From 9f5f4f12d71fc68f4bfa6fb86026c4d3f29d763b Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:34:55 +0200 Subject: [PATCH 06/17] Update .github/ISSUE_TEMPLATE/minor_version_update.md Co-authored-by: Peter Jiang <35584807+pjiang-dev@users.noreply.github.com> Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index 5d420c41ea331..2a884de8ef4b9 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -1,7 +1,7 @@ --- name: Update Minor Version about: Used by our Release Champion to add steps when upgrading minor version -title: '' + title: 'docs: Upgrade guide for vX.Y to vX.Z' assignees: '' --- From 5e958ed8396d64f6b316e5903377a802c11421ea Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:35:05 +0200 Subject: [PATCH 07/17] Update .github/ISSUE_TEMPLATE/minor_version_update.md Co-authored-by: Peter Jiang <35584807+pjiang-dev@users.noreply.github.com> Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index 2a884de8ef4b9..24e31e34c9066 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -5,7 +5,7 @@ about: Used by our Release Champion to add steps when upgrading minor version assignees: '' --- -# Vx.1 to x.2 +# vX.Y to X.Z ## Breaking Changes From 89433baf5d3a0a2963180a91cbdac305fc889de7 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:35:14 +0200 Subject: [PATCH 08/17] Update .github/ISSUE_TEMPLATE/minor_version_update.md Co-authored-by: Peter Jiang <35584807+pjiang-dev@users.noreply.github.com> Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/minor_version_update.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md index 24e31e34c9066..82560de68f64a 100644 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ b/.github/ISSUE_TEMPLATE/minor_version_update.md @@ -3,6 +3,7 @@ name: Update Minor Version about: Used by our Release Champion to add steps when upgrading minor version title: 'docs: Upgrade guide for vX.Y to vX.Z' assignees: '' +labels: 'component:docs' --- # vX.Y to X.Z From f8a9b5aa2bfb60a59059cf0555c78c4d1f3c8df2 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:38:35 +0200 Subject: [PATCH 09/17] Add upgrade guide for minor version changes Signed-off-by: Revital Barletz --- docs/operator-manual/minor_version_upgrade.md | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/operator-manual/minor_version_upgrade.md diff --git a/docs/operator-manual/minor_version_upgrade.md b/docs/operator-manual/minor_version_upgrade.md new file mode 100644 index 0000000000000..d368788683dff --- /dev/null +++ b/docs/operator-manual/minor_version_upgrade.md @@ -0,0 +1,53 @@ +--- +name: Update Minor Version +about: Used by our Release Champion to add steps when upgrading minor version +title: 'docs: Upgrade guide for vX.Y to vX.Z' +assignees: '' +labels: 'component:docs' +--- + +# vX.Y to X.Z + +## Breaking Changes + +What changed that could affect your setup: +Deprecated flags / behavior removals +Deprecated fields +Other incompatible behavior or semantics changes between versions + (Add list here) + +## Custom Healthchecks Added + +New built-in health checks added in this release: +Add any new CRD health support added in this version) + +## Kustomize Upgraded + +Bundled Kustomize version bump: +Any breaking behavior +Notes about specific upstream behavior changes (e.g., namespace propagation fixes). + +## Helm Upgraded + +Bundled Helm version bump: +Any breaking behavior +Verify if your charts depend on any features tied to Helm versions. + +## API / Security Changes + +Changes in API surface or security behavior: +Any removal of sensitive fields or changed authentication defaults + +## Behavioral Improvements / Fixes + +Operational stability and performance fixes: +Minor stability, reconciler improvements, bug fixes + +## Deprecated Items + +Flags / behavior to be removed in future releases +Any deprecated config API or CLI flags + +## Upgrade Instructions + +Example: CLI upgrade command From db134d32d39c518fba9c97b5f60d0720ef208bf7 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:39:14 +0200 Subject: [PATCH 10/17] Delete .github/ISSUE_TEMPLATE/minor_version_update.md Signed-off-by: Revital Barletz --- .../ISSUE_TEMPLATE/minor_version_update.md | 54 ------------------- 1 file changed, 54 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/minor_version_update.md diff --git a/.github/ISSUE_TEMPLATE/minor_version_update.md b/.github/ISSUE_TEMPLATE/minor_version_update.md deleted file mode 100644 index 82560de68f64a..0000000000000 --- a/.github/ISSUE_TEMPLATE/minor_version_update.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -name: Update Minor Version -about: Used by our Release Champion to add steps when upgrading minor version - title: 'docs: Upgrade guide for vX.Y to vX.Z' -assignees: '' -labels: 'component:docs' ---- - -# vX.Y to X.Z - -## Breaking Changes - -What changed that could affect your setup: -Deprecated flags / behavior removals -Deprecated fields -Other incompatible behavior or semantics changes between versions - (Add list here) - -## Custom Healthchecks Added - -New built-in health checks added in this release: -Add any new CRD health support added in this version) - -## Kustomize Upgraded - -Bundled Kustomize version bump: -Any breaking behavior -Notes about specific upstream behavior changes (e.g., namespace propagation fixes). - -## Helm Upgraded - -Bundled Helm version bump: -Any breaking behavior -Verify if your charts depend on any features tied to Helm versions. - -## API / Security Changes - -Changes in API surface or security behavior: -Any removal of sensitive fields or changed authentication defaults - -## Behavioral Improvements / Fixes - -Operational stability and performance fixes: -Minor stability, reconciler improvements, bug fixes - -## Deprecated Items - -Flags / behavior to be removed in future releases -Any deprecated config API or CLI flags - -## Upgrade Instructions - -Example: CLI upgrade command - From 4e6e8ccd9400744a67ca38de5097ce7ab2ca1646 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Wed, 7 Jan 2026 13:49:12 +0200 Subject: [PATCH 11/17] Fix documentation PR link in release checklist Updated the documentation PR template link for the next minor version in the release checklist. Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/release.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/release.md b/.github/ISSUE_TEMPLATE/release.md index cf180f1743bae..e98e717d7ec0f 100644 --- a/.github/ISSUE_TEMPLATE/release.md +++ b/.github/ISSUE_TEMPLATE/release.md @@ -41,7 +41,6 @@ Target GA date: ___. __, ____ Thanks to all the folks who spent their time contributing to this release in any way possible! ``` - [ ] Monitor support channels for issues, cherry-picking bugfixes and docs fixes as appropriate during the RC period (or delegate this task to an Approver and coordinate timing) - - [ ] After creating the RC, open a documentation PR for the next minor version using [this](minor_version_update.md) template. ## GA Release Checklist @@ -85,3 +84,5 @@ Target GA date: ___. __, ____ ``` - [ ] (For the next release champion) Review the [items scheduled for the next release](https://github.com/orgs/argoproj/projects/25). If any item does not have an assignee who can commit to finish the feature, move it to the next release. - [ ] (For the next release champion) Schedule a time mid-way through the release cycle to review items again. + - [ ] After creating the RC, open a documentation PR for the next minor version using [this](../../docs/operator-manual/minor_version_upgrade.md) template. + From a030bc70799ae54281eef59393b2a4d9a530b83e Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Sun, 11 Jan 2026 13:28:38 +0200 Subject: [PATCH 12/17] Move minor version upgrade documentation template Signed-off-by: Revital Barletz --- docs/operator-manual/{ => templates}/minor_version_upgrade.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/operator-manual/{ => templates}/minor_version_upgrade.md (100%) diff --git a/docs/operator-manual/minor_version_upgrade.md b/docs/operator-manual/templates/minor_version_upgrade.md similarity index 100% rename from docs/operator-manual/minor_version_upgrade.md rename to docs/operator-manual/templates/minor_version_upgrade.md From a7edcca42e0c48112e71c9da8c4d018525023716 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Sun, 11 Jan 2026 13:29:11 +0200 Subject: [PATCH 13/17] Fix link to minor version upgrade template Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/release.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/release.md b/.github/ISSUE_TEMPLATE/release.md index e98e717d7ec0f..4c1fe08561b8b 100644 --- a/.github/ISSUE_TEMPLATE/release.md +++ b/.github/ISSUE_TEMPLATE/release.md @@ -84,5 +84,5 @@ Target GA date: ___. __, ____ ``` - [ ] (For the next release champion) Review the [items scheduled for the next release](https://github.com/orgs/argoproj/projects/25). If any item does not have an assignee who can commit to finish the feature, move it to the next release. - [ ] (For the next release champion) Schedule a time mid-way through the release cycle to review items again. - - [ ] After creating the RC, open a documentation PR for the next minor version using [this](../../docs/operator-manual/minor_version_upgrade.md) template. + - [ ] After creating the RC, open a documentation PR for the next minor version using [this](../../docs/operator-manual/templates/minor_version_upgrade.md) template. From 311fbf870ac7144625c5dde9056f8333a2a4d73b Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 12 Jan 2026 12:42:08 +0200 Subject: [PATCH 14/17] Update docs/operator-manual/templates/minor_version_upgrade.md Co-authored-by: Regina Voloshin Signed-off-by: Revital Barletz --- docs/operator-manual/templates/minor_version_upgrade.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/docs/operator-manual/templates/minor_version_upgrade.md b/docs/operator-manual/templates/minor_version_upgrade.md index d368788683dff..b7f78fbf434b5 100644 --- a/docs/operator-manual/templates/minor_version_upgrade.md +++ b/docs/operator-manual/templates/minor_version_upgrade.md @@ -1,10 +1,3 @@ ---- -name: Update Minor Version -about: Used by our Release Champion to add steps when upgrading minor version -title: 'docs: Upgrade guide for vX.Y to vX.Z' -assignees: '' -labels: 'component:docs' ---- # vX.Y to X.Z From 84b5d552e1c1b2fee2c669f233bba21bd67e03c5 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Mon, 12 Jan 2026 12:47:03 +0200 Subject: [PATCH 15/17] Revise minor version upgrade documentation Reorganized sections for clarity and added details on health checks. Signed-off-by: Revital Barletz --- .../templates/minor_version_upgrade.md | 42 +++++++++---------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/operator-manual/templates/minor_version_upgrade.md b/docs/operator-manual/templates/minor_version_upgrade.md index b7f78fbf434b5..b668a815254ec 100644 --- a/docs/operator-manual/templates/minor_version_upgrade.md +++ b/docs/operator-manual/templates/minor_version_upgrade.md @@ -1,4 +1,3 @@ - # vX.Y to X.Z ## Breaking Changes @@ -9,10 +8,25 @@ Deprecated fields Other incompatible behavior or semantics changes between versions (Add list here) -## Custom Healthchecks Added +## Behavioral Improvements / Fixes -New built-in health checks added in this release: -Add any new CRD health support added in this version) +Operational stability and performance fixes: +Minor stability, reconciler improvements, bug fixes + +## API Changes + +Changes in API surface: +Any removal of fields or changed API defaults + +## Security Changes + +Changes in security behavior: +Any removal of sensitive fields or changed authentication defaults + +## Deprecated Items + +Flags / behavior to be removed in future releases +Any deprecated config API or CLI flags ## Kustomize Upgraded @@ -26,21 +40,7 @@ Bundled Helm version bump: Any breaking behavior Verify if your charts depend on any features tied to Helm versions. -## API / Security Changes - -Changes in API surface or security behavior: -Any removal of sensitive fields or changed authentication defaults - -## Behavioral Improvements / Fixes - -Operational stability and performance fixes: -Minor stability, reconciler improvements, bug fixes - -## Deprecated Items - -Flags / behavior to be removed in future releases -Any deprecated config API or CLI flags - -## Upgrade Instructions +## Custom Healthchecks Added -Example: CLI upgrade command +New built-in health checks added in this release: +Add any new CRD health support added in this version) From d1604fcbcf1a16a4d25ec7368d2cac0ee80f3d4e Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Tue, 13 Jan 2026 13:49:32 +0200 Subject: [PATCH 16/17] Clean up comments in minor_version_upgrade.md Removed comments from the minor version upgrade template. Signed-off-by: Revital Barletz --- .../templates/minor_version_upgrade.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/operator-manual/templates/minor_version_upgrade.md b/docs/operator-manual/templates/minor_version_upgrade.md index b668a815254ec..afd9c346a1186 100644 --- a/docs/operator-manual/templates/minor_version_upgrade.md +++ b/docs/operator-manual/templates/minor_version_upgrade.md @@ -2,45 +2,45 @@ ## Breaking Changes -What changed that could affect your setup: + ## Behavioral Improvements / Fixes -Operational stability and performance fixes: -Minor stability, reconciler improvements, bug fixes + ## API Changes -Changes in API surface: -Any removal of fields or changed API defaults + ## Security Changes -Changes in security behavior: -Any removal of sensitive fields or changed authentication defaults + ## Deprecated Items -Flags / behavior to be removed in future releases -Any deprecated config API or CLI flags + ## Kustomize Upgraded -Bundled Kustomize version bump: + ## Helm Upgraded -Bundled Helm version bump: + ## Custom Healthchecks Added -New built-in health checks added in this release: -Add any new CRD health support added in this version) + From e1e71201a5d0c73ae457286a5e3a037fff9bc0a8 Mon Sep 17 00:00:00 2001 From: Revital Barletz Date: Tue, 13 Jan 2026 15:49:33 +0200 Subject: [PATCH 17/17] Remove duplicate documentation PR checklist item Removed duplicate checklist item for opening documentation PR after creating RC. Signed-off-by: Revital Barletz --- .github/ISSUE_TEMPLATE/release.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/release.md b/.github/ISSUE_TEMPLATE/release.md index 4c1fe08561b8b..5a7b3e081e0cc 100644 --- a/.github/ISSUE_TEMPLATE/release.md +++ b/.github/ISSUE_TEMPLATE/release.md @@ -41,6 +41,7 @@ Target GA date: ___. __, ____ Thanks to all the folks who spent their time contributing to this release in any way possible! ``` - [ ] Monitor support channels for issues, cherry-picking bugfixes and docs fixes as appropriate during the RC period (or delegate this task to an Approver and coordinate timing) + - [ ] After creating the RC, open a documentation PR for the next minor version using [this](../../docs/operator-manual/templates/minor_version_upgrade.md) template. ## GA Release Checklist @@ -84,5 +85,3 @@ Target GA date: ___. __, ____ ``` - [ ] (For the next release champion) Review the [items scheduled for the next release](https://github.com/orgs/argoproj/projects/25). If any item does not have an assignee who can commit to finish the feature, move it to the next release. - [ ] (For the next release champion) Schedule a time mid-way through the release cycle to review items again. - - [ ] After creating the RC, open a documentation PR for the next minor version using [this](../../docs/operator-manual/templates/minor_version_upgrade.md) template. -