Release process

Consider the following to be something of a checklist. JFoxSOAF's release process consists of tagging one or more version control modules. For the 2.x development path, the module list to consider for tagging consists of the following:

  • JFoxSOAF-1.0
  • JFoxSOAF-1.0-RC3
  • JFoxSOAF-1.0-RC2
  • JFoxSOAF-1.0-RC1
  • JFoxSOAF-1.0-M3
  • JFoxSOAF-1.0-M2
  • JFoxSOAF-1.0-M1
After tagging the release (or each module), take a few minimal steps to assure that the archives are in the expected place and valid. Announce your release via news outlets such as web page changes, email announcements, press releases, etc. For instance, many Apache projects update the jakarta-site2/xdocs/site/news.xml document and their Freshmeat entry.

Tagging an individual module

  1. Send email to the development mailing list announcing a version control freeze for tagging.
  2. Check out fresh working copy of CVS module you're going to tag.
  3. Set the release version number in JFoxSOAF project.xml and/or Ant default.properties. For example, 3.0-dev would become 3.0-b1 or 3.0-rc1.
  4. Update any dependency changes (possibly caused by previous module tagging). For JFoxSOAF, this consists of modifying the version and jar attributes of each dependency element.
  5. Perform a successful build and test suite execution, and run the clean target to remove any generated files.
  6. Commit your changes to the version control repository.
  7. Tag the release via cvs -q tag PROJECT_VERSION_MODIFIER . An example release tag is JFoxSOAF_2_2_M1 or JFoxSOAF_3_0_RC1.
  8. Set the next development version number in JFoxSOAF project.xml and/or Ant default.properties and commit the change to the version control repository. For example, 3.0-b1 would become 3.0-b2-dev.
  9. Send email to the development mailing list announcing completion of the tag.