Re: maven Website - I'm struggling getting the information I seek

2006-05-30 Thread Pete Marvin King


  hello, try to download the maven book at www.mergere.com. There's a
link on the
  mid-right for the book,  "Better Builds With Maven".  There's a lot of
information
  there that you might find useful.

   hope this helps...=)


cheers,
pete marvin


Stefan Arentz wrote:
> On 5/30/06, Marc Weber <[EMAIL PROTECTED]> wrote:
>> Hello I'm using mvn for 2 month now and I'm till struggling finding the
>> finding the documentation on the maven.apache.org website.
>
> Same here. I started using Maven 2 about a month ago. It has been
> *extremely* painful because of the complete chaos that is called
> documentation. Figuring out how plugins work is impossible because the
> documentation is either missing or halve-baked. I have more success
> with asking things on the list here, or searching the list archives.
> Or even reading source code of plugins.
>
> It is a pleasure to use Maven for my project, but it was all but a
> simple start.
>
> I think the Maven team should set some standards for documentation and
> simply ask every plugin developer to take care of it or else simply
> drop the plugin.
>
> S.
>
> -
> 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]



Re: maven Website - I'm struggling getting the information I seek

2006-05-30 Thread Stefan Arentz

On 5/30/06, Marc Weber <[EMAIL PROTECTED]> wrote:

Hello I'm using mvn for 2 month now and I'm till struggling finding the
finding the documentation on the maven.apache.org website.


Same here. I started using Maven 2 about a month ago. It has been
*extremely* painful because of the complete chaos that is called
documentation. Figuring out how plugins work is impossible because the
documentation is either missing or halve-baked. I have more success
with asking things on the list here, or searching the list archives.
Or even reading source code of plugins.

It is a pleasure to use Maven for my project, but it was all but a simple start.

I think the Maven team should set some standards for documentation and
simply ask every plugin developer to take care of it or else simply
drop the plugin.

S.

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



maven Website - I'm struggling getting the information I seek

2006-05-30 Thread Marc Weber
Hello I'm using mvn for 2 month now and I'm till struggling finding the
finding the documentation on the maven.apache.org website. An example:

I was looking for the filename of the user profile setting file
(settings.xml) ..  I got this two pages using google and menu:

http://maven.apache.org/maven-settings/settings.html#class_settings
http://maven.apache.org/ref/current/maven-settings/settings.html

Both look very similar except that the one contains the settings.xml
filename but the other does't.. At the first glance I didn't realize
this..

On the main download page there is no hint where to get the source..
You have to go to the FAQ or to "How to help".. I would never have
looked here an first place..

On the left there is a BIG header "Project Documentation"...
but no link to click on the next link shows information about
mailinglists... You can find it under "Quick Links"

When trying to find a the meaning of a tag? Where to go?
Quick Links -> Documentation -> Scroll to the bottom to find *reference* 
Here it needs some endurance to ignore the guides and introdictions..

At the beginning I was confused wether I was at maven 1 or 2 docs..
It took me some time to finde the maven 1x and 2x links on top..

But perhaps I'm just not used to this site..

Greetings
Marc Weber

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