This is an automated email from the ASF dual-hosted git repository.
pingtimeout pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git
The following commit(s) were added to refs/heads/main by this push:
new b324fc3be Update release guide to reference the proposed vote e-mail
(#3377)
b324fc3be is described below
commit b324fc3bea339efbb9c07346ef845e2e373e3a26
Author: Pierre Laporte <[email protected]>
AuthorDate: Thu Jan 8 10:28:05 2026 +0100
Update release guide to reference the proposed vote e-mail (#3377)
Now that #3150 has been merged, a VOTE e-mail is pre-generated by the
third workflow so that there is less room for error. The release guide
has been updated to reflect this.
There is no pre-generated Incubator vote e-mail as part of the third
workflow. This is acceptable in that eventually, after graduation, that
would become unnecessary. But also that it could cause confusion as
there would be two proposed e-mail bodies in the third workflow.
Recommendation is to let the release manager created the Incubator vote
e-mail manually.
---
.../release-3-build-and-publish-artifacts.yml | 2 +-
.../release-guides/semi-automated-release-guide.md | 72 +++++----------------
.../release-guides/github-workflow-3-detail.png | Bin 0 -> 205289 bytes
3 files changed, 16 insertions(+), 58 deletions(-)
diff --git a/.github/workflows/release-3-build-and-publish-artifacts.yml
b/.github/workflows/release-3-build-and-publish-artifacts.yml
index 190157515..9ec2f85c0 100644
--- a/.github/workflows/release-3-build-and-publish-artifacts.yml
+++ b/.github/workflows/release-3-build-and-publish-artifacts.yml
@@ -469,7 +469,7 @@ jobs:
*
https://dist.apache.org/repos/dist/dev/incubator/polaris/${version_without_rc}
Helm charts are available on:
- * https://dist.apache.org/repos/dist/dev/incubator/polaris/helm-chart
+ *
https://dist.apache.org/repos/dist/dev/incubator/polaris/helm-chart/${version_without_rc}
NB: you have to build the Docker images locally in order to test
Helm charts.
diff --git
a/site/content/community/release-guides/semi-automated-release-guide.md
b/site/content/community/release-guides/semi-automated-release-guide.md
index f44c844c1..3b5748341 100644
--- a/site/content/community/release-guides/semi-automated-release-guide.md
+++ b/site/content/community/release-guides/semi-automated-release-guide.md
@@ -112,6 +112,7 @@ The third Github workflow to run is [`Release - 3 - Build
and publish release ar
* Build the Helm chart
* Create signature and checksum for all package files
* Copy package files to Apache dist dev repository
+* Generate an e-mail to notify the community of the availability of the
release candidate
This workflow must be run from an RC tag (e.g.,
`apache-polaris-1.3.0-incubating-rc0`). Select the tag from the `Use workflow
from` dropdown in the Github Actions UI. Selecting any other reference in the
Github Actions UI will result in a failure.
@@ -119,57 +120,9 @@ This workflow must be run from an RC tag (e.g.,
`apache-polaris-1.3.0-incubating
## Start the vote thread
-The last step for a release candidate is to create a VOTE thread on the dev
mailing list.
+The last step for a release candidate is to send a VOTE thread on the dev
mailing list. The run details page for the third workflow contains a
ready-to-send e-mail to notify the community of the availability of the release
candidate and start the vote.
-Recommended title subject:
-
-```
-[VOTE] Release Apache Polaris [major].[minor].[patch] (rc[N])
-```
-
-Recommended content:
-
-```
-Hi everyone,
-
-I propose that we release the following RC as the official Apache Polaris
[major].[minor].[patch]
-release.
-
-* This corresponds to the tag:
apache-polaris-[major].[minor].[patch]-incubating-rc[N]
-*
https://github.com/apache/polaris/commits/apache-polaris-[major].[minor].[patch]-incubating-rc[N]
-* https://github.com/apache/polaris/tree/<SHA1>
-
-The release tarball, signature, and checksums are here:
-*
https://dist.apache.org/repos/dist/dev/incubator/polaris/[major].[minor].[patch]-incubating
-
-Helm charts are available on:
-*
https://dist.apache.org/repos/dist/dev/incubator/polaris/helm-chart/[major].[minor].[patch]-incubating/
-
-NB: you have to build the Docker images locally in order to test Helm charts.
-
-You can find the KEYS file here:
-* https://downloads.apache.org/incubator/polaris/KEYS
-
-Convenience binary artifacts are staged on Nexus. The Maven repositories URLs
-are:
-* https://repository.apache.org/content/repositories/orgapachepolaris-<ID>/
-
-Please download, verify, and test according to the release verification guide,
which can be found at
-https://polaris.apache.org/community/release-verify/.
-
-Please vote in the next 72 hours.
-
-[ ] +1 Release this as Apache polaris [major].[minor].[patch]
-[ ] +0
-[ ] -1 Do not release this because...
-
-Only PPMC members and mentors have binding votes, but other community members
-are encouraged to cast non-binding votes. This vote will pass if there are 3
-binding +1 votes and more binding +1 votes than -1 votes.
-
-NB: if this vote passes, a new vote has to be started on the Incubator general
-mailing list.
-```
+
The next steps depend on the vote result.
@@ -210,6 +163,12 @@ A new vote is starting in the Apache Incubator general
mailing list.
## Start a new vote thread on the Incubator general mailing list
As Polaris is an Apache Incubator project, you now have to start a new vote on
the Apache Incubator general mailing list.
+The Incubator vote e-mail resembles the Polaris vote e-mail, with a few
additional details:
+* It mentions that the Polaris (podling) vote has passed
+* It contains links to the Polaris vote thread and the vote result thread
+* It contains a checklist for the IPMC members to verify the release artifacts
+
+Note that unlike for the podling vote, no e-mail is pre-generated by the
Github workflow.
You have to send this email to [email protected]:
@@ -230,25 +189,24 @@ Vote result thread:
* https://lists.apache.org/thread/<VOTE RESULT>
* This corresponds to the tag:
apache-polaris-[major].[minor].[patch]-incubating-rc[N]
-*
https://github.com/apache/polaris/commits/apache-polaris-[major].[minor].[patch]-rc[N]
+*
https://github.com/apache/polaris/commits/apache-polaris-[major].[minor].[patch]-incubating-rc[N]
* https://github.com/apache/polaris/tree/<SHA1>
The release tarball, signature, and checksums are here:
-*
https://dist.apache.org/repos/dist/dev/incubator/polaris/[major].[minor].[patch]
+*
https://dist.apache.org/repos/dist/dev/incubator/polaris/[major].[minor].[patch]-incubating
Helm charts are available on:
-* https://dist.apache.org/repos/dist/dev/incubator/polaris/helm-chart
+*
https://dist.apache.org/repos/dist/dev/incubator/polaris/helm-chart/[major].[minor].[patch]-incubating
NB: you have to build the Docker images locally in order to test Helm charts.
You can find the KEYS file here:
* https://downloads.apache.org/incubator/polaris/KEYS
-Convenience binary artifacts are staged on Nexus. The Maven
-repositories URLs are:
+Convenience binary artifacts are staged on Nexus. The Maven repositories URLs
are:
* https://repository.apache.org/content/repositories/orgapachepolaris-<ID>/
-Please download, verify, and test according to the release verification guide,
which can be found at
-https://polaris.apache.org/community/release-verify/.
+Please download, verify, and test according to the release verification guide,
which can be found at:
+*
https://polaris.apache.org/community/release-guides/release-verification-guide/
Please vote in the next 72 hours.
diff --git a/site/static/img/release-guides/github-workflow-3-detail.png
b/site/static/img/release-guides/github-workflow-3-detail.png
new file mode 100644
index 000000000..11eb51322
Binary files /dev/null and
b/site/static/img/release-guides/github-workflow-3-detail.png differ
