I think one of Ant's main strengths was not that it was a great build tool (that XML format was quite painful to use when I'm honest about it) but the documentation was brilliant that it was thus very easy to get things working. The maven documentation is not really complete on the website and there a tonne of undocumented features and odd behaviours.
I would agree the documetation needs some work and in my opinion three things need attention: 1) A general reorganisation for the reference docs so that they are as accessible as the basic tutorials and get that access from the maven front page so its one click away just like Ant's was. 2) The reference material needs more detail. Specific things like what all the options for a value do. 3) More advanced tutorials for complex project structures, probably in the reference documents. For example a lot more detail on multimodule projects would be nice, things like how to have a dependency on a multi-module project and pulling in all the code. How to publish a multi-module project to a repository etc. Its not just multimodule, its also how to build anything other than a library. I'll think about it a bit more and propose a structure and tutorials that I think we need to write. Paul Keeble ----- Original Message ---- From: Denis Bessmertniy <[EMAIL PROTECTED]> To: Maven Users List <[email protected]> Sent: Monday, 24 September, 2007 9:56:01 AM Subject: RE: Why Maven is Hard? 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] ___________________________________________________________ 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]
