Release Process

Update site

1. Remove the following folders and files from the *.updatesite plug-in.
   • features/
   • plugins/
   • artifacts.jar
   • content.jar
   • logs.zip
2. Open *.updatesite/site.xml in Eclipse.
3. Remove all the features listed in site.xml but not any categories.
4. Select the the category in the Site Map. Then, press the Add Feature... button and select the feature plug-in from the popped up dialog.
5. Press the button Build.

Publish

1. Install the new release of from the local file system into fresh instances of Eclipse to make sure that it installs successfully.
2. Copy the contents of the directory *.updatesite into public_html/updates of the machine hosting the update site.
3. Repeat the first step for the remote update site.

Tag

1. Be careful not to delete any build.xml files. For some reason, the build script of the update site sometimes deletes some of the other build scripts.

2. Commit the changes to the update site and change log. Use a commit message of the following form

    Released v<x>.<y>.<z>.<qualifier>
   
    This commit belongs to issue #<release-issue>.
   

In the above message, <x>, <y>, <z> and <qualifier> are parts of the version of the generated feature, and <release-issue> is the number of the issue devoted to this particular release.

1. Push the commit to the remote repository.

2. Tag the commit containing the new release using the following command.

    git tag v<x>.<y>.<z>.<qualifier> <commit-sha>
   

Push the created tag to the remote repository using the following command.

    git push --tags

1. List a summary of the fixed issues on the release page of the github repository.

Store

1. Push the update site to the release git repository and tag it similarly.