forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <>
Subject [VOTE] please review release candidate then vote
Date Tue, 01 Feb 2011 03:47:08 GMT
We need people to review the release candidate and to
test it on your projects, especially on different operating
systems and Java version. See testing hints below.

Download the release candidate and supporting files:

For Windows get *.zip (md5sum c04600e8befeaf005d5e4b9d6c8034f9)
For UNIX get *.tar.gz (md5sum ea58a078e3861d4dfc8bf3296a53a5f8)
Get the *.asc and *.md5 that match your chosen download.

Java 1.5 or later is required.

Testing and vote period concludes Monday 2011-02-07 at 22:00 UTC [2].
Anyone can test and vote, not just PMC members.
However only the PMC votes are binding [3].

When voting, quote the md5sum to ensure that we are all
using the correct final release candidate package. The votes
need to happen against the final source release package.

If we need to build another release candidate, due to
necessary changes to the code or documentation [1],
then we need to vote reagarding that package.

PMC members need to satisfy themselves that the actual
final release package meets the ASF principles.

During this week we do need to hear about both successes
and failures. Please report your operating system
and Java versions and Jetty/Tomcat versions.

So we have approximately 6 days.

Here are some hints for actual testing:

  * Verify the release, especially if you are a committer.
  * Ensure that the compressed archive will unpack properly.
  * Follow the README.txt and index.html
  * Set $FORREST_HOME and $PATH appropriately.
  * Try it with different Java versions.
  * Try it with different versions of Apache Tomcat or Jetty.
  * Many known issues are already recorded at our Jira.
  * Don't worry too much about minor bugs. We are looking
    for blockers, such as it will not run.
  * Please add other discovered issues to Jira.

* Make a fresh site ...
    cd my-new-dir
    forrest seed-sample
    forrest run ... use the local jetty server.
    forrest ... build the whole site from the command-line.
    forrest war ... use your own full Jetty or Tomcat.

* Try it on the Forrest core docs ...
    cd site-author
    forrest run

* Forrest was already pre-built. Try building it again.
    cd main
    build clean
    build test-sample

* Try it on your own project, especially if you have
    a project sitemap and use some extra plugins.

* If you are a user of forrestbot then try that.

* Try building and installing the forrestbar.

[1] create final release candidate if necessary
Saturday 2011-02-05 at 22:00 UTC

[2] end of vote on final release candidate and commence the upload phase
Monday 2011-02-07 at 22:00 UTC (i.e. planned release date)

[3] Guidelines for Voting
"A lazy majority vote requires 3 binding +1 votes
and more binding +1 votes than -1 votes".

View raw message