This page (revision-26) was last changed on 18-Jan-2025 15:36 by Juan Pablo 

This page was created on 14-Apr-2017 13:43 by Juan Pablo

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Version Date Modified Size Author Changes ... Change note
26 18-Jan-2025 15:36 12 KB Juan Pablo to previous JSPWIKI-1202: add notes to check for build reproducibility
25 18-Jan-2025 15:35 12 KB Juan Pablo to previous | to last JSPWIKI-1202: add notes to check for build reproducibility
24 02-Aug-2022 21:33 11 KB Juan Pablo to previous | to last
23 30-Jul-2022 12:59 11 KB Juan Pablo to previous | to last no need to modify jspwiki-bom file
22 13-Jan-2022 14:07 12 KB Juan Pablo to previous | to last added pre-release checks section
21 18-Dec-2021 17:09 11 KB Juan Pablo to previous | to last announce e-mail should be sent using only plain text
Incoming links Outgoing links
How to release
How to release

Difference between version and

At line 7 added one line
* Check version on {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}}
At line 9 changed one line
mvn clean install apache-rat:rat -Papache-release # generates artifacts, checks for AL headers
mvn clean verify apache-rat:rat -Papache-release # generates artifacts, checks for AL headers
At line 21 changed one line
* Publish latest javadocs
* Publish latest javadocs and binary compatibility reports
At line 56 added 7 lines
!! Pre-release checks
Verify that {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}} contains the appropiate JSPWiki version
* on {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}}, {{BUILD}} and {{POSTFIX}} constants should be empty strings.
The maven release process does not change these values on these files, so this has to be done manually.
At line 60 changed one line
mvn clean install apache-rat:rat -Papache-release
mvn clean verify apache-rat:rat -Papache-release
At line 96 changed one line
# Select org.apache.jspwiki from the list of repositories, then click [Close|https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository] using "Apache JSPWiki X.Y.Z" as the description to allow others to see the repository.
# Select org.apache.jspwiki from the list of repositories, then click [Close|https://help.sonatype.com/repomanager2/staging-releases/managing-staging-repositories#ManagingStagingRepositories-ClosinganOpenRepository] using "Apache JSPWiki X.Y.Z" as the description to allow others to see the repository.
At line 98 changed one line
* __Svn copy binaries and source to {{https://dist.apache.org/repos/dist/dev/jspwiki/X.Y.Z/}}__ (remember to also copy accompanying {{sha}} and {{asc}} files), suggested structure:
* __Svn copy binaries and source to {{https://dist.apache.org/repos/dist/dev/jspwiki/X.Y.Z/}}__ (remember to also copy accompanying {{sha512}} and {{asc}} files), suggested structure:
At line 125 added 2 lines
You can see a curated changelog at https://jspwiki-wiki.apache.org/Wiki.jsp?page=NewInX.Y
At line 142 added 6 lines
== Reproducible Builds ==
JSPWiki should follow Reproducible Builds (https://reproducible-builds.org/). In order to verify
artifacts' build reproducibility, please use
mvn verify artifact:compare -Dreference.repo=https://repository.apache.org/content/repositories/staging/
At line 160 changed 2 lines
* __Publish javadocs on jspwiki.apache.org__
## add the javadocs artifact to the [pom.xml which builds the site|https://github.com/apache/jspwiki-site/blob/jbake/pom.xml#L78]
* __Publish javadocs and binary compatibility reports on jspwiki.apache.org__
At line 178 added one line
## modify the three links on [https://github.com/apache/jspwiki-site/blob/jbake/src/main/jbake/assets/japicmp/index.html] so they point to the new binary compatibility reports
At line 188 added 6 lines
!! Add the next release version to JIRA
* (Bulk) transition all X.Y.Z issues from {{Resolved}} to {{Closed}}. To avoid clogging dev@jspwiki.a.o, there's no need to send bulk e-mails for these changes
* Mark the released version as {{Released}} with a release date
* Add the [next version number to JIRA|https://issues.apache.org/jira/plugins/servlet/project-config/JSPWIKI/versions]
At line 174 changed one line
* Send the following from an apache.org address to [announce@apache.org|mailto:announce@apache.org], [user@jspwiki.apache.org|mailto:user@jspwiki.apache.org], [dev@jspwiki.apache.org|mailto:dev@jspwiki.apache.org]:
* Send the following from an apache.org address, using plain text only, to [announce@apache.org|mailto:announce@apache.org], [user@jspwiki.apache.org|mailto:user@jspwiki.apache.org], [dev@jspwiki.apache.org|mailto:dev@jspwiki.apache.org]:
At line 202 changed one line
!! Add the next release version to JIRA
!! First push post-release
At line 204 changed 2 lines
* Add the [next version number to JIRA|https://issues.apache.org/jira/plugins/servlet/project-config/JSPWIKI/versions]
* Mark the released version as "released" with a release date
Ensure that {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}} contains next development versions.
At line 209 changed 4 lines
* Cygwin mixes Windows path with cygdrive, so {{mvn release:prepare}} fails on svn commit
** Current workaround: perform release via {{cmd.exe}}
* git doesn't allow to perform an {{mvn release:perform}} because it detects file(s) permissions change (i.e. change from old 0755 to new 0644)
* Git doesn't allow to perform an {{mvn release:perform}} because it detects file(s) permissions change (i.e. change from old 0755 to new 0644)
At line 218 changed one line
* {{mvn release:prepare}} doesn't find {{svn}} credentials
* {{mvn release:prepare}} doesn't find {{git}} credentials
At line 222 changed one line
*** {{svn.apache.org}}: to be able to create tags
*** {{github.com}}: to be able to create tags
At line 231 changed 3 lines
* [Publishing Maven Artifacts - setup your development environment|http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env]
* [Maven release plugin|http://maven.apache.org/maven-release/maven-release-plugin/]
* Repository management with Nexus: [Chapter 11. Improved Releases with the Nexus Staging Suite|http://books.sonatype.com/nexus-book/reference/staging-sect-intro.html]
* [Publishing Maven Artifacts - setup your development environment|https://www.apache.org/dev/publishing-maven-artifacts.html#dev-env]
* [Maven release plugin|https://maven.apache.org/maven-release/maven-release-plugin/]
* Repository management with Nexus: [Staging Releases|https://help.sonatype.com/repomanager2/staging-releases]
This page (revision-26) was last changed on 18-Jan-2025 15:36 by Juan Pablo  Top