This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/sis-site.git
The following commit(s) were added to refs/heads/main by this push:
new 606e9e68 Update release instructions.
606e9e68 is described below
commit 606e9e68a3c7cb46e729811c0f1057ae1d49eb9a
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Wed Oct 1 18:04:40 2025 +0200
Update release instructions.
---
content/release-management.md | 19 ++++++--------
content/release-notes/1.5.md | 2 +-
static/DOAP.rdf | 2 +-
static/templates/release-discuss.html | 41 ------------------------------
static/templates/release-vote.html | 47 ++++++++++++++++++++++-------------
5 files changed, 39 insertions(+), 72 deletions(-)
diff --git a/content/release-management.md b/content/release-management.md
index ceab6a98..17639097 100644
--- a/content/release-management.md
+++ b/content/release-management.md
@@ -495,7 +495,7 @@ the URL of the temporary Maven repositories created by
Nexus.
Usually, only the 3 last digits need to be modified.
```bash
-cd $SIS_RC_DIR/../release/test/maven
+cd $SIS_RC_DIR/../test/maven
# Edit <url> in pom.xml before to continue.
mvn compile
svn commit -m "Test project for SIS $NEW_VERSION-RC$RELEASE_CANDIDATE"
@@ -610,8 +610,6 @@ git commit --message "Update javadoc for SIS $NEW_VERSION."
```
-## Publish Maven artifacts {#publish-artifacts}
-
## Stage the source, binary and Javadoc artifacts {#stage}
The official Apache releases are the files in the `$DIST_DIR` directory.
@@ -620,11 +618,12 @@ We have already staged the Javadoc and binaries.
Now stage the sources and cleanup:
```bash
-git archive --prefix apache-sis-$NEW_VERSION-src/ --output
$DIST_DIR/apache-sis-$NEW_VERSION-src.zip $NEW_VERSION-RC
+cd $SIS_RC_DIR
+git archive --prefix apache-sis-$NEW_VERSION-src/ --output
$DIST_DIR/apache-sis-$NEW_VERSION-src.zip $NEW_VERSION-RC$RELEASE_CANDIDATE
cd $DIST_DIR
zip -d apache-sis-$NEW_VERSION-bin.zip
apache-sis-$NEW_VERSION/lib/org.apache.sis.openoffice.jar
zip -d apache-sis-$NEW_VERSION-bin.zip
apache-sis-$NEW_VERSION/lib/org.apache.sis.referencing.epsg.jar
-zip -d apache-sis-$NEW_VERSION-bin.zip
apache-sis-$NEW_VERSION/lib/lib/org.apache.sis.referencing.database.jar
+zip -d apache-sis-$NEW_VERSION-bin.zip
apache-sis-$NEW_VERSION/lib/org.apache.sis.referencing.database.jar
```
Sign the source, Javadoc and binary artifacts:
@@ -648,13 +647,14 @@ find . -name "*.asc" -exec gpg --verify '{}' \;
```
-# Integration test {#integration-tests}
+## Test the binary {#test-binary}
Force the Java version to the one supported by Apache SIS (adjust `JDK11_HOME`
as needed).
Specify the URL to the nexus repository, where `####` is the identifier of the
staging repository.
```bash
unset SIS_DATA
+unset PATH_TO_FX
export JAVA_HOME=$JDK11_HOME
export JDK_JAVA_OPTIONS="-enableassertions -Dorg.apache.sis.epsg.downloadURL"
export
JDK_JAVA_OPTIONS=$JDK_JAVA_OPTIONS=https://repository.apache.org/content/repositories/orgapachesis-####
@@ -663,9 +663,6 @@ export
JDK_JAVA_OPTIONS=$JDK_JAVA_OPTIONS=https://repository.apache.org/content/
export JDK_JAVA_OPTIONS="$JDK_JAVA_OPTIONS
-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=127.0.0.1:8000"
```
-
-## Test the binary {#test-binary}
-
Unzip the binaries and execute the examples documented in the [command-line
interface page](./command-line.html).
```bash
@@ -680,6 +677,7 @@ wget
https://sis.staged.apache.org/examples/coordinates/CanadianCities.csv
./bin/sis identifier
https://sis.staged.apache.org/examples/crs/EquivalentDefinition.wkt
./bin/sis transform --sourceCRS EPSG:4267 --targetCRS EPSG:4326
AmericanCities.csv
./bin/sis transform --sourceCRS EPSG:4267 --targetCRS EPSG:4326
CanadianCities.csv
+rm --recursive data/Databases/SpatialMetadata # For testing EPSG download
from GUI.
./bin/sisfx
```
@@ -766,8 +764,6 @@ It will not yet be published on `https://sis.apache.org`.
* Create a VOTE email thread on `dev@` to record votes as replies.
A template is available [here](templates/release-vote.html).
-* Create a DISCUSS email thread on `dev@` for any vote questions.
- A template is available [here](templates/release-discuss.html).
* Perform a review of the release and cast your vote:
* a -1 vote does not necessarily mean that the vote must be redone, however it
is usually a good idea
to rollback the release if a -1 vote is received. See _Recovering from a
vetoed release_ below.
@@ -841,7 +837,6 @@ The output shall report only good signatures.
## Announce the release {#announce}
-* WAIT 24 hours after committing releases for mirrors to replicate.
* Publish the web site updates:
* On the `asf-site` branch, execute `git merge asf-staging` and push.
* Make an announcement about the release on the `dev@`, `users@`, and
`announce@` mailing lists.
diff --git a/content/release-notes/1.5.md b/content/release-notes/1.5.md
index 9b667bae..53854a11 100644
--- a/content/release-notes/1.5.md
+++ b/content/release-notes/1.5.md
@@ -2,7 +2,7 @@
title: SIS 1.5 Release notes
---
-* Release date: **2025-10-03**
+* Release date: **2025-10-05**
* Next release
* [Previous release](1.4.html)
* [Incompatible changes](#compatibility)
diff --git a/static/DOAP.rdf b/static/DOAP.rdf
index 1dc24454..8706e11a 100644
--- a/static/DOAP.rdf
+++ b/static/DOAP.rdf
@@ -170,7 +170,7 @@
<release>
<Version>
<name>Apache SIS 1.5 — ISO 19111 and EPSG upgrade</name>
- <created>2025-10-03</created>
+ <created>2025-10-05</created>
<revision>1.5</revision>
</Version>
<Version>
diff --git a/static/templates/release-discuss.html
b/static/templates/release-discuss.html
deleted file mode 100644
index bf56ebba..00000000
--- a/static/templates/release-discuss.html
+++ /dev/null
@@ -1,41 +0,0 @@
-<!DOCTYPE html>
-<html>
- <head>
- <title>Release discuss</title>
- <meta charset="UTF-8">
- </head>
- <body>
- <p>
- <b>To:</b> [email protected]<br>
- <b>Subject:</b> [DISCUSS] Apache <abbr title="Spatial Information
System">SIS</abbr>
- ${version} <abbr title="Release Candidate">RC</abbr>${candidate}
- </p><p>
- Discussion thread for vote on Apache <abbr title="Spatial Information
System">SIS</abbr>
- ${version} release candidate ${candidate}.
- </p><p>
- If you have any questions or feedback or to post results of validating
the release, please reply to this thread.
- Once you verify the release, please post your vote to the VOTE thread.
- </p><p>
- For reference, the Apache release guide —
https://www.apache.org/legal/release-policy.html
- </p><p>
- Some tips to validate the release before you vote:
- </p>
-
- <ul>
- <li>Download the binary version and run the 5 minute or 10 minute
tutorial as described in [1].</li>
- <li>Download the source files from compressed files and build (which
includes tests).</li>
- <li>Verify the distribution for the required LICENSE and NOTICE
files</li>
- <li>Verify if all the staged files are signed and the signature is
verifiable.</li>
- <li>Verify if the signing key in the project's KEYS file is hosted on a
public server.</li>
- </ul>
-
- <p>
- Thanks for your time in validating the release and voting,<br>
- {Release Manager}<br>
- (On Behalf of <abbr title="Spatial Information System">SIS</abbr>
- <abbr title="Project Management Committee ">PMC</abbr>)<br>
- </p>
-
- <pre>[1] https://sis.staged.apache.org/command-line.html</pre>
- </body>
-</html>
diff --git a/static/templates/release-vote.html
b/static/templates/release-vote.html
index 9aad7ccf..b7570154 100644
--- a/static/templates/release-vote.html
+++ b/static/templates/release-vote.html
@@ -13,28 +13,26 @@
This is a call for a vote on the following Apache <abbr title="Spatial
Information System">SIS</abbr>
${version} release candidate ${candidate} artifacts:
</p>
- <ul>
- <li><p>Change log/release notes:<br>
- https://sis.staged.apache.org/release-notes/${version}.html</p></li>
- <li><p>All Release Artifacts:<br>
- https://dist.apache.org/repos/dist/dev/sis/${version}/RC1/</p></li>
- <li><p>PGP release keys (signed using GnuPG):<br>
- https://downloads.apache.org/sis/KEYS</p></li>
- <li><p>Maven staging repository:
-<pre><repositories>
+ <blockquote>
+ <p>Change log/release notes:<br>
+ https://sis.staged.apache.org/release-notes/${version}.html</p>
+ <p>All Release Artifacts:<br>
+ https://dist.apache.org/repos/dist/dev/sis/${version}/RC1/</p>
+ <p>PGP release keys (signed using GnuPG):<br>
+ <a
href="https://downloads.apache.org/sis/KEYS";>https://downloads.apache.org/sis/KEYS</a></p>
+ <p>Maven staging repository:</p>
+ <pre><repositories>
<repository>
<id>sis.staging</id>
<name><abbr title="Spatial Information System">SIS</abbr> staging
repository</name>
<url>https://repository.apache.org/content/repositories/orgapachesis-{XXX}</url>
</repository>
-</repositories></pre><p></li>
- <li><p>Web site <a
href="https://sis.staged.apache.org/";>https://sis.staged.apache.org/</a>
- except for Javadoc which will be updated the release day.
- The developer guide is also a work in progress not yet
updated.</p></li>
- </ul>
-
+</repositories></pre>
+ <p>Web site except for Javadoc (which will be updated the release
day):<br>
+ <a
href="https://sis.staged.apache.org/";>https://sis.staged.apache.org/</a></p>
+ </blockquote>
<p>
- Please verify the artifacts and vote. The vote will be open for 72 hours.
+ Please verify the artifacts and vote. The vote will be open for at least
72 hours.
Closing date may be changed to a later day if testers need more time.
</p>
<pre>[ ] +1 approve
@@ -44,7 +42,22 @@
<p>
If no issue is reported, the content of above staging repositories will
be moved as-is (no recompilation)
to Apache mirrors and Maven Central repository when the release will
happen.
- If blocking issues are reported, a new staging repository at a new URL
will be created for the second release candidate.
+ If blocking issues are reported, a new staging repository at a new URL
will be created for another release candidate.
+ Some tips to validate the release before you vote:
</p>
+ <ul>
+ <li>For reference, the Apache release guide —
+ <a
href="https://www.apache.org/legal/release-policy.html";>https://www.apache.org/legal/release-policy.html</a></li>
+ <li>Download the source files from compressed files and build (requires
Gradle 8.8).</li>
+ <li>Verify the distribution for the required LICENSE and NOTICE
files.</li>
+ <li>Verify if all the staged files are signed and the signature is
verifiable.</li>
+ <li>Verify if the signing key in the project's KEYS file is hosted on a
public server.</li>
+ <li>Download the binary version and run some examples described in
+ <a
href="https://sis.staged.apache.org/command-line.html";>https://sis.staged.apache.org/command-line.html</a>.
+ For running with <abbr>EPSG</abbr> data, execute the following
command first:</li>
+ </ul>
+ <blockquote><pre>export
JDK_JAVA_OPTIONS="-Dorg.apache.sis.epsg.downloadURL=https://repository.apache.org/content/repositories/orgapachesis-1062";</pre></blockquote>
+
+ <p>Thanks for your time in validating the release and voting.</p>
</body>
</html>
