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.
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.
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.
David Sean Taylor wrote:
On Aug 6, 2007, at 8:46 AM, Mansour wrote:
I have been already trying to learn jetspeed for more than 2 weeks. I
give up, then I go back because it's the only framework that has what
I need. The documentation sucks. Honestly, I regret the time I have
wasted, it would have been easier for me to write my own security
layer for roles/groups management. The documents sometimes instruct
you to use maven-1 and then switches to maven-2. And worse, none of
the instruction works.
Our build situation with two Mavens is confusing, I agree. The
history: we started with a Maven-1 build, and then Maven came out with
Maven-2. The problem was that we still had lots of users building
custom builds with Maven-1.
Thus we tried to support both versions of Maven, and it seems the
documentation has become muddied in the process.
We are in the process of moving to one single Maven-2 build, and
greatly simplifying the build in the new 2.2 development branch.
I know it feels good to just shoot off and say "the documentation
sucks" and frankly I don't blame you. If you could also point out a
few areas where the documentation is wrong, that would help others.
Im not asking to review the entirely documentation, just point out a
few particular areas where you got stuck badly.
I
I tried the installer for jetspeed-2 and it works fine. But a lot of
things that I don't need and frustrated about. What are all these
directories. I don't want an embeded tomcat. I need to understand how
to deploy jetspeed and customize it. Then I will dive into how to add
my own portlets.
The installer comes with an embedded Tomcat to simplify support.
It would also be nice to have installers for Tomcat and Websphere and
JBoss
The last thing I was trying to do is following this page
http://portals.apache.org/jetspeed-2/getting-started-binary.html
I created a directory ~/workspace/jetspeed. And put in that directory
build.properties , which contains:
basedir = ~/workspace/myportal
maven.repo.remote = http://www.bluesunrise.com/maven/,
http://www.ibiblio.org/maven/, http://dist.codehaus.org/,
http://cvs.apache.org/repository
then, when I ran: maven j2:portal.genapp , I get:
BUILD FAILED
File......
/home/mansour/.maven/cache/maven-jetspeed2-plugin-2.1.2/plugin.jelly
Element... fail
Line...... 735
Column.... 42
Required property org.apache.jetspeed.server.home undefined. See
http://portals.apache.org/jetspeed-2/getting-started.html.
Total time: 2 seconds
Finished at: Mon Aug 06 12:44:02 ADT 2007
Is there a clean place to learn about Jetspeed-2 other than the docs.
If you want to build with Maven-2, there is the Wiki
http://wiki.apache.org/portals/Jetspeed2/Maven2BuildSupport
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
