I've started a new thread for this discussion so as not to pollute
the vote thread.
- There should be a travel sample source distribution that has no
binaries or third party dependencies included.
>
The travel sample distribution packaging was discussed on threads [1]
and [2].
The third-party binaries are included because the travel sample has
an ant build as well as a maven build. If these binaries weren't
included, it would be necessary for people running the ant build to
manually download these dependencies and set the following environment
variables to point to their locations:
JUNIT_JAR
OPENEJB_HOME
JAXWS_HOME (if building or running on JDK 5)
In the previous dev list discussion the need for users to do these
prereq downloads and set environment variables was felt to be a
significant inconvenience, so the packaging was changed to include
these files within the travel sample distribution (see [3] and [4]).
The only prereq download that's needed is the Tuscany SCA Java
binary distribution.
In a minor note, having
the BUILDING, CHANGES, LICENSE, NOTICE, README and RELEASE_NOTES on
the root of the travel sample might make things simpler to generate
the source distribution and also for users starting from the tag or
project root.
>
The BUILDING, CHANGES, LICENSE, NOTICE, README and RELEASE_NOTES
are already in the root directory of the travel sample distribution,
so I'm not sure what you are suggesting. The packaging is as follows:
tuscany-scatours-1.0
BUILDING
CHANGES
LICENSE
NOTICE
README
RELEASE_NOTES
travelsample
...source for the travel sample...
lib
...third-party binary dependencies...
- The binary distribution could then handle the binary portions of
the travel sample with the necessary binaries (maybe non-tuscany
dependencies) to run the application. The current distribution seems
to be more aligned as a binary distribution, rather then a source
distribution.
>
The travel sample was previously built as separate source and binary
distributions. However, from the previous dev list discussion (see [2])
it was felt that there was little value in providing a binary-only
distribution as the value of this sample to users was in seeing the
source and building it rather than just running it.
The RC1 distribution is a source distribution of the travel sample
that also includes a minimum set of third-party binaries needed to
build and run the travel sample using ant. The travel sample source
and the third-party binaries are clearly separated from each other
by putting them into different top-level directories in the distribution
("travelsample" for the source code and "lib" for the dependencies).
It would be possible to split the "travelsample" and "lib" portions into
separate downloads, something like apache-tuscany-scatours-src-1.0.tar.gz
and apache-tuscany-scatours-dependencies.tar.gz. This seems more
complicated for users because they wouldn't have a simple "download
and go" solution but would first need to understand whether they need
one or both of these downloads and how to combine them correctly if
they need both of them.
Simon
[1] http://www.mail-archive.com/[email protected]/msg11512.html
[2] http://www.mail-archive.com/[email protected]/msg11997.html
[3] http://www.mail-archive.com/[email protected]/msg11519.html
[4] http://www.mail-archive.com/[email protected]/msg11545.html
-------- Original Message --------
Subject: Re: [VOTE] Release Tuscany SCA Travel Sample 1.0
Date: Sun, 23 May 2010 18:09:04 -0700
From: Luciano Resende <[email protected]>
Reply-To: [email protected]
To: [email protected]
References: <[email protected]>
On Fri, May 21, 2010 at 4:03 PM, Simon Nash <[email protected]> wrote:
Please review and vote on RC1 of the SCA Travel Sample 1.0 release.
The distribution artifacts and RAT report are available for review at:
http://people.apache.org/~nash/tuscany/travelsample-1.0-RC1/
The release tag is at:
https://svn.apache.org/repos/asf/tuscany/sca-java-1.x/tags/travelsample-1.0-RC1/
There are no maven artifacts included in this release.
As this has been posted on a weekend, I'll wait 72 hours from start of
business Monday (US Pacific Time) before closing the vote.
Simon
Legal files look ok
I'm seeing the same build issues as described by Raymond
Other comments/recommendations :
- There should be a travel sample source distribution that has no
binaries or third party dependencies included. In a minor note, having
the BUILDING, CHANGES, LICENSE, NOTICE, README and RELEASE_NOTES on
the root of the travel sample might make things simpler to generate
the source distribution and also for users starting from the tag or
project root.
- The binary distribution could then handle the binary portions of
the travel sample with the necessary binaries (maybe non-tuscany
dependencies) to run the application. The current distribution seems
to be more aligned as a binary distribution, rather then a source
distribution.
--
Luciano Resende
http://people.apache.org/~lresende
http://twitter.com/lresende1975
http://lresende.blogspot.com/
