On Aug 7, 2007, at 3:46 PM, Mansour wrote:
If I can edit the documentation I would have. Mainly in the getting
started tutorial:
1- where to get the settings.xml from. I was told in one of the
emails that it resides in the source directory. I would fix this.
That is documented clearly in the WIKI page
http://wiki.apache.org/portals/Jetspeed2/Maven2BuildSupport
"The first step in using the Maven2 build is to either:
copy the settings.xml.sample to ~/.m2/settings.xml
or
encorporate the settings in this file into your existing
Maven2 configuration."
We will be looking into replacing the current documentation with this
WIKI, sorry you sent you down the wrong path
2- I will include the repo as a zip file for each release so that
if one of the jars fails, the user can unzip the repo and use it
locally.
We have done that before for people on the list for Maven-1, however
with Maven-2, in theory, this kind of solution should not be
necessary except when you have some extreme firewall limititation
3- When I was stuck in the getting started tutorial and decided to
read "Getting started with Jetspeed-2 binaries guide <http://
portals.apache.org/jetspeed-2/getting-started-binary.html>" page at
http://portals.apache.org/jetspeed-2/getting-started-binary.html I
ran into maven-1 instructions.
The same was true to Getting started with Jetspeed-2 source guide
<http://portals.apache.org/jetspeed-2/getting-started-source.html>
I never used maven before, and to try to learn maven-2, then find
that I should have installed and worked with maven-1 is really
frustrating.
Don't get me wrong about what I am about to say. This is just an
example. Have a look at this http://www.opensymphony.com/osuser/.
The first lines in the page say:
"/Note that currently no download of osuser is available, as we
feel the documentation is insufficient to merit a binary release.
However, we do encourage you to download and build the source code
via CVS. Hopefully a full 1.0 release will be available soon./"
These few lines saved me a lot of time !!
I am trying to learn more about jetspeed, and I will send you any
comments about the documentation.
Thank you.
Well I don't think we need to stop releases, as you can download the
installer and it works fine
We are painfully finding out that Maven is not the easiest build
environment for everyone, even if it is the best build tool available
for Java developers
For custom portal development, please try out the latest tutorial
(granted incomplete) found here and let me know if that goes easier
for you
It should just get you up and running and sections 2-6 should be
completed over the next month
http://people.apache.org/~taylor/tutorial/docs/site/
I know you don't want to use an installer that contains Tomcat, but
just consider the tutorial as a way to learn, and including in Tomcat
really cuts down on the support questions for us
Once you are familiar with the tutorial, from there we can discuss
how to integrate with real production environments, database and
binary upgrade issues
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
