Help

Built with Seam

You can find the full source code for this website in the Seam package in the directory /examples/wiki. It is licensed under the LGPL.

This document describes the release process for the Weld SE. We assume you are in the root directory of the SE. Before you start, take a look at the getting started guide.

Weld Documentation release version numbers track the Weld Core release on which it is based.

Ensure all dependencies are released

Maven is strict (which is no bad thing!) about ensuring that all dependencies are non-snapshot before starting the release. So, check the properties in pom.xml, and release any dependencies needed.

Checking whether you are good to go

The maven release plugin is very powerful, and will transform all your POMs to a release version, tag them, and then revert trunk or the branch back to a development version. We can also do a dry run to check there are no snapshot dependencies (for example, a developer might have mistakenly put the version in a sub-module). If there are any problems, you need to fix them, and check in the changes.

Check how complete the translations are. Any translation which is less than 80% complete should be excluded. To do this, make sure you have publican installed (on Fedora, also install translate-toolkit. To exclude a translation, edit the POM and comment out the translation.

Make sure all the changes are checked in using svn status.

Now, run mvn release:prepare --batch-mode -Drelease -DdevelopmentVersion=A.B.C-SNAPSHOT -DreleaseVersion=X.Y.Z-Q -Dtag=X.Y.Z-Q -DdryRun - this will run through the release process, but not actually perform the tagging.

If the build fails, go back and correct the problems

Tagging the release

Now we are ready to tag the release. Make sure the tag doesn't already exist, and run mvn release:prepare --batch-mode -Drelease -DdevelopmentVersion=A.B.C-SNAPSHOT -DreleaseVersion=X.Y.Z-Q -Dtag=X.Y.Z-Q -Dresume=false.

Once this finishes, verify that the tag is correct (e.g. use a browser).

Perform the release to maven

Now, run mvn release:perform nexus:staging-close -Drelease. You should see all the artifacts uploaded to the staging repository.

QA process

  • View the pdf, html and html_single docs, and do a quick eyeball check of them.