> -----Original Message-----
> From: Jason van Zyl [mailto:[EMAIL PROTECTED]]
> Sent: Monday, May 27, 2002 5:02 PM
> To: Turbine Users List
> Subject: RE: building / debugging turbine and dependencies
>
Q:
> You make send patches and we will apply them. What problems
> did you have
> getting going?
A:
> The instructions for building aren't very consistent when I look at
> them. They should be obvious and in your face, probably
> something Maven
> should generate ...
:)
All I was going to do was generate a quickstart section using Maven, then suggest in
each turbine project build reference how to use it.
A personal problem I have had with most Apache projects is navigating the
documentation. When the left sidebar changes between projects, I sometimes can't
figure out how to get back to a page that I was looking at without going through the
browser history. It's hella confusing for a new user. For instance, the
http://jakarta.apache.org/turbine/maven/bootstrap.html file turned out to be the key
to the puzzle, but still isn't clear enough -- note to self on this one... it needs to
be a bit clearer that the maven.home directory is *different* than the cvs checkout
directory for the maven sources. Anyway, I started looking at other pages for
cross-reference, then couldn't find my way back to this page! It's an unfortunate
that the more documentation there is, the more likely people are to read it faster,
causing minor (but critical) details to be overlooked. What's even more unfortunate
is the generation of more documentation to overcome this only worsens the problem.
To that end, Maven is absolutely wonderful! Once I got it bootstrapped, I was blown
away!
I'll send some stuff as I get it...
:b
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
