There are questions that I have that I simply can't find answers for at all! 
Not only are the details not in the documentation but they aren't even blogged 
about.

Just compare the level of documentation in Ant verses Maven and its a night and 
day difference. Don't get me wrong there is a lot of documentation for Maven I 
just don't think its as accessible or as detailed. If you have 5 options for a 
parameter then the details of what each does is essential and that is just 
missing (for instance what does a dependency being of type pom mean?! I had to 
write an example app to see what it meant).

Ant has no such corner cases, it documents every single value and parameter. 
Maven still has better documentation than many other open source projects but 
its not a 5 minute lookup, its several hours of searching and prototyping on 
google.

I'd never consider looking for ant documentation anywhere except their site, 
for maven I prefer to look else where as the site is not detailed enough.

Paul K

----- Original Message ----
From: Michael McCallum <[EMAIL PROTECTED]>
To: Maven Users List <users@maven.apache.org>
Sent: Monday, 24 September, 2007 11:04:10 AM
Subject: Re: Why Maven is Hard?

with a few subtle exceptions related to bugs that are fixed in 2.0.7 every 
question i've been asked in regard to using maven2 has been found in the 
documentation in under 5 minutes

On Monday 24 September 2007 20:56, Denis Bessmertniy wrote:
> I said that it is hard because with maven I step on rake from time to time.
>
> By the way I have read the Better build with maven book.
>
> And my idea will be more correct: not maven hard, but maven is bad
> documented on its web site.
>
>
> -----Original Message-----
> From: Rodrigo Madera [mailto:[EMAIL PROTECTED]
> Sent: Monday, September 24, 2007 11:50 AM
> To: Maven Users List
> Subject: Re: Why Maven is Hard?
>
> Denis,
>
> Will all due respect, do you really wish to just read a page and get
> running and fully understanding Maven?
> Do you really say Maven is hard because you didn't understand your very
> first plugin encounter, which happens to be nothing less than the EAR
> plugin?
>
> Maven is a complex system that simplifies projects, but it does so with
> concepts that need to be viewed.
> You need to read the book. You need to read it so you will understand.
>
> If you're a fast reader you'll be doing Hello World in less than two hours
> knowing what you are doing.
>
> Sincerely,
> Rodrigo
>
> On 9/24/07, Denis Bessmertniy <[EMAIL PROTECTED]>
>
> wrote:
> > That is. I haven't need to read fat books when I studied Ant, for
> > example. That is. Look to
> > http://maven.apache.org/plugins/maven-ear-plugin/ear-mojo.html#modules
> >
> > modules  The ear modules configuration.
> >
> >     * Type: org.apache.maven.plugin.ear.EarModule[]
> >     * Required: No
> >
> >
> > What is org.apache.maven.plugin.ear.EarModule[] here? How I may
> > understand what I need to pass?
> > Standard Maven plugins really bad documented.
> >
> >
> >
> > -----Original Message-----
> > From: Nick Stolwijk [mailto:[EMAIL PROTECTED]
> > Sent: Monday, September 24, 2007 11:17 AM
> > To: Maven Users List
> > Subject: Re: Why Maven is Hard?
> >
> > What documentation did you read? There are two very good books about
> > maven
> > 2
> > (and they are free to download)
> >
> > 1. Maven the Definitive Guide (http://www.sonatype.com/book/) 2.
> > Better Builds with Maven
> > (http://www.devzuz.com/web/guest/products/resources#BBWM)
> >
> > Sometimes, the documentation for some of the plugins is hard to
> > understand.
> > But mostly, this are third party plugins, so the Maven team can't do
> > anything about it. You will have to mail the team of the plugin.
> >
> > Hth,
> >
> > Nick Stolwijk
> >
> > Denis Bessmertniy wrote:
> > > It is interesting why maven is so hard to understand? Why it is not
> > > well documented? (It is all my own opinions) I haven't so much
> > > probmlems with Ant, for example.
> > >
> > >
> > >
> > > --------------------------------------------------------------------
> > > - 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]
> >
> >
> > ---------------------------------------------------------------------
> > 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]

-- 
Michael McCallum
Enterprise Engineer
mailto:[EMAIL PROTECTED]

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]






      ___________________________________________________________ 
Want ideas for reducing your carbon footprint? Visit Yahoo! For Good  
http://uk.promotions.yahoo.com/forgood/environment.html

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to