Re: [Proposal] Documenting Maven

2006-06-30 Thread Brett Porter
On 29/06/2006 2:54 AM, Alexandre Poitras wrote: I had started some documentation based on the Trails idea : http://docs.codehaus.org/display/MAVENUSER/The+Maven+2+tutorial but stopped since "Better Builds with Maven" was exactly what I wanted to produce. Feel to use anything. Sorry to discoura

Re: [Proposal] Documenting Maven

2006-06-28 Thread Alexandre Poitras
I had started some documentation based on the Trails idea : http://docs.codehaus.org/display/MAVENUSER/The+Maven+2+tutorial but stopped since "Better Builds with Maven" was exactly what I wanted to produce. Feel to use anything. On 6/25/06, Dennis Lundberg <[EMAIL PROTECTED]> wrote: Jason van Z

Re: [Proposal] Documenting Maven

2006-06-25 Thread Dennis Lundberg
Jason van Zyl wrote: On 19 Jun 06, at 12:37 AM 19 Jun 06, Brett Porter wrote: John Casey wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? btw

Re: [Proposal] Documenting Maven

2006-06-21 Thread Eric Redmond
On 6/19/06, Rinku <[EMAIL PROTECTED]> wrote: Hi, Some sites: [A] http://java.sun.com/javase/ [B] http://ant.apache.org/ Some notes: 1) L.H.S nav categories are concise. For example, "Reference" in [A] above has links to all documentation resources. "Community" has all the stuff about forum

Re: [Proposal] Documenting Maven

2006-06-19 Thread Raphaël Piéroni
Hi Jason and List, The last result was on the mavenuser wiki. I can also found some paper notes i wrote some month ago. If you are interrested, i could rewrote what i had. Raphaël 2006/6/19, Jason van Zyl <[EMAIL PROTECTED]>: On 19 Jun 06, at 8:37 AM 19 Jun 06, Brett Porter wrote: > > Do

Re: [Proposal] Documenting Maven

2006-06-19 Thread Rinku
t; To: "Maven Developers List" Sent: Tuesday, June 20, 2006 1:12 AM Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:54 AM 19 Jun 06, Brett Porter wrote: On 19/06/2006 10:47 PM, Jason van Zyl wrote: Then I'll work with John and yourself to bring them back into th

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
ose a search-ability/adds a better search. -Original Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: Humans aren'

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
ose a search-ability/adds a better search. -Original Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: Humans aren'

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
On 19 Jun 06, at 8:54 AM 19 Jun 06, Brett Porter wrote: On 19/06/2006 10:47 PM, Jason van Zyl wrote: Then I'll work with John and yourself to bring them back into the discussions on the mailing list. I'm curious to see what might fall out though I might just be setting myself up to be dis

Re: [Proposal] Documenting Maven

2006-06-19 Thread Brett Porter
Hopefully the reorg solution doesn't lose a search-ability/adds a better search. -Original Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun

Re: [Proposal] Documenting Maven

2006-06-19 Thread Brett Porter
On 19/06/2006 10:47 PM, Jason van Zyl wrote: Then I'll work with John and yourself to bring them back into the discussions on the mailing list. I'm curious to see what might fall out though I might just be setting myself up to be disappointed by lack of involvement but I'll give a shot. I think

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
M To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: Humans aren't capable to read more then 9 entries. Many of the questions asked on the user list are actually in the guides. So why don't they find it? http://m

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
On 19 Jun 06, at 8:37 AM 19 Jun 06, Brett Porter wrote: Do we really think there are any ideas that haven't been encountered in all these messages? Absolutely. If 10 people make a site I guarantee you something will fall out that hasn't been seen. If users don't want to help in this

Re: [Proposal] Documenting Maven

2006-06-19 Thread Brett Porter
. Hopefully the reorg solution doesn't lose a search-ability/adds a better search. -Original Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geo

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: Humans aren't capable to read more then 9 entries. Many of the questions asked on the user list are actually in the guides.

Re: [Proposal] Documenting Maven

2006-06-19 Thread Brett Porter
On 19/06/2006 10:16 PM, Jason van Zyl wrote: A lot of the folks here and users had ideas on how to make the site better so how about we solicit for a users' favourite site with respect to usability. Actually, that's what I was aiming for. There was a lot of feedback before, so I wanted to ma

RE: [Proposal] Documenting Maven

2006-06-19 Thread Jeff Jensen
ginal Message- From: Jason van Zyl [mailto:[EMAIL PROTECTED] Sent: Monday, June 19, 2006 7:21 AM To: Maven Developers List Subject: Re: [Proposal] Documenting Maven On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: > Humans aren't capable to read more then 9 entries. > Many

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
On 19 Jun 06, at 8:08 AM 19 Jun 06, Geoffrey De Smet wrote: Humans aren't capable to read more then 9 entries. Many of the questions asked on the user list are actually in the guides. So why don't they find it? http://maven.apache.org/guides/index.html links to a lot of good guides, but the

Re: [Proposal] Documenting Maven

2006-06-19 Thread Jason van Zyl
On 19 Jun 06, at 12:37 AM 19 Jun 06, Brett Porter wrote: John Casey wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? btw: http://mail-archi

Re: [Proposal] Documenting Maven

2006-06-19 Thread Brett Porter
Yep, I think this thread was unanimous on that point. - Brett On 19/06/2006 10:08 PM, Geoffrey De Smet wrote: Humans aren't capable to read more then 9 entries. Many of the questions asked on the user list are actually in the guides. So why don't they find it? http://maven.apache.org/guides/in

Re: [Proposal] Documenting Maven

2006-06-19 Thread Geoffrey De Smet
Humans aren't capable to read more then 9 entries. Many of the questions asked on the user list are actually in the guides. So why don't they find it? http://maven.apache.org/guides/index.html links to a lot of good guides, but the way it is structured is plain wrong imho: - When people want to

Re: [Proposal] Documenting Maven

2006-06-18 Thread Brett Porter
John Casey wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? btw: http://mail-archives.apache.org/mod_mbox/maven-dev/200603.mbox/[EMAIL PROTECTE

Re: [Proposal] Documenting Maven

2006-06-18 Thread Brett Porter
Hi, Some thoughts here, then going to follow with a mail that incorporates some more of the past discussions, and hopefully, finally, an action plan. John Casey wrote: I've put my ideas here: http://www.commonjava.org/~jdcasey/maven-documentation-proposal.html Prefer this inline for a coupl

Re: [Proposal] Documenting Maven

2006-06-16 Thread Dennis Lundberg
See comments inline... John Casey wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? Basically, I've talked to Brett, Jason, and a few other Maven

Re: [Proposal] Documenting Maven

2006-06-16 Thread Dennis Lundberg
Jason van Zyl wrote: On 16 Jun 06, at 3:24 PM 16 Jun 06, Dennis Lundberg wrote: Wendy Smoak wrote: On 6/14/06, John Casey <[EMAIL PROTECTED]> wrote: Basically, I've talked to Brett, Jason, and a few other Maven developers, and I think it's time we started making website documentation a top p

Re: [Proposal] Documenting Maven

2006-06-16 Thread Jeremy Whitlock
I think the search interface is a great addition but shouldn't be used in place of a front page. I would think the front page would have generic links to areas of information. Things like: User: Getting Started Dev: Getting Started References (XML xsd/dtds with human readable information for ge

Re: [Proposal] Documenting Maven

2006-06-16 Thread Jason van Zyl
On 16 Jun 06, at 3:24 PM 16 Jun 06, Dennis Lundberg wrote: Wendy Smoak wrote: On 6/14/06, John Casey <[EMAIL PROTECTED]> wrote: Basically, I've talked to Brett, Jason, and a few other Maven developers, and I think it's time we started making website documentation a top priority for Maven.

Re: [Proposal] Documenting Maven

2006-06-16 Thread Dennis Lundberg
Wendy Smoak wrote: On 6/14/06, John Casey <[EMAIL PROTECTED]> wrote: Basically, I've talked to Brett, Jason, and a few other Maven developers, and I think it's time we started making website documentation a top priority for Maven. General thoughts -- I never navigate the Maven site, I go st

Re: [Proposal] Documenting Maven

2006-06-16 Thread Jason van Zyl
On 16 Jun 06, at 4:18 AM 16 Jun 06, Trygve Laugstøl wrote: Trygve Laugstøl wrote: Edwin Punzalan wrote: Definitely deserves +1 However, I'm still torn between using apt and a wiki site but whichever wins I think the obvious casualty will be the site-plugin. If we continue on using the p

Re: [Proposal] Documenting Maven

2006-06-16 Thread Trygve Laugstøl
Trygve Laugstøl wrote: Edwin Punzalan wrote: Definitely deserves +1 However, I'm still torn between using apt and a wiki site but whichever wins I think the obvious casualty will be the site-plugin. If we continue on using the pages generated by the site plugin, and based from John Casey'

Re: [Proposal] Documenting Maven

2006-06-16 Thread Trygve Laugstøl
Edwin Punzalan wrote: Definitely deserves +1 However, I'm still torn between using apt and a wiki site but whichever wins I think the obvious casualty will be the site-plugin. If we continue on using the pages generated by the site plugin, and based from John Casey's "Core Documentation" po

Re: [Proposal] Documenting Maven

2006-06-16 Thread John Tolentino
John Casey wrote: [SNIP] It will come as no surprise that I think you should encourage more user-contributed documentation. (Aside from submitting patches for the apt source-- that's too high a barrier if you just want to share a plugin configuration example that works for you.) Agreed. I'

Re: [Proposal] Documenting Maven

2006-06-15 Thread Edwin Punzalan
Definitely deserves +1 However, I'm still torn between using apt and a wiki site but whichever wins I think the obvious casualty will be the site-plugin. If we continue on using the pages generated by the site plugin, and based from John Casey's "Core Documentation" point #2, it will be a m

Re: [Proposal] Documenting Maven

2006-06-15 Thread jerome lacoste
On 6/15/06, John Casey <[EMAIL PROTECTED]> wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? Basically, I've talked to Brett, Jason, and a few other

Re: [Proposal] Documenting Maven

2006-06-15 Thread John Casey
[SNIP] It will come as no surprise that I think you should encourage more user-contributed documentation. (Aside from submitting patches for the apt source-- that's too high a barrier if you just want to share a plugin configuration example that works for you.) Agreed. I'd like to see if we

Re: [Proposal] Documenting Maven

2006-06-15 Thread Wendy Smoak
On 6/14/06, John Casey <[EMAIL PROTECTED]> wrote: Basically, I've talked to Brett, Jason, and a few other Maven developers, and I think it's time we started making website documentation a top priority for Maven. General thoughts -- I never navigate the Maven site, I go straight to Google. (So

Re: [Proposal] Documenting Maven

2006-06-15 Thread Raphaël Piéroni
Hi John, Here are inlined some propositions. 2006/6/15, John Casey <[EMAIL PROTECTED]>: Hi everyone, [SNIP] I've put my ideas here: http://www.commonjava.org/~jdcasey/maven-documentation-proposal.html I apologize if it looks like I ripped off someone else's ideas...I honestly cannot fin

Re: [Proposal] Documenting Maven

2006-06-14 Thread Jeremy Whitlock
Rahul, I agree that the accompanying projects/sub-projects should be documented but that also seems like common sense. I also agree heavily with Jimisola. When I first tried Maven, I canned it within a mont or so due to lack of documentation. That is getting better with "Better Builds With Ma

Re: [Proposal] Documenting Maven

2006-06-14 Thread Rinku
+1 for documentation reorganization on the Maven website. Also, quickly wanted to add that documenting Maven would, IMHO, encompass a number of other projects/sub-projects (For instance ones appearing in the top navigation on the Maven homepage). I think we need to include them in the scope a

Re: [Proposal] Documenting Maven

2006-06-14 Thread Jimisola Laursen
this message in context: http://www.nabble.com/-Proposal--Documenting-Maven-t1789063.html#a4874428 Sent from the Apache Maven Developers List forum at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands,

Re: [Proposal] Documenting Maven

2006-06-14 Thread Dan Diephouse
A big +1! - Dan John Casey wrote: Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? Basically, I've talked to Brett, Jason, and a few other Maven develo

Re: [Proposal] Documenting Maven

2006-06-14 Thread Jeremy Whitlock
John, I'll put a +1 on that one. I am fairly new to Maven development and non-standard Maven use and I feel that the documentation is lacking. Even when there is documentation it isn't complete. Take care, Jeremy On 6/14/06, John Casey <[EMAIL PROTECTED]> wrote: Hi everyone, I know we've

[Proposal] Documenting Maven

2006-06-14 Thread John Casey
Hi everyone, I know we've talked about this quite a bit already. Actually, I'm having trouble finding the past threads on this topic in my email...can someone who knows please link them in? Basically, I've talked to Brett, Jason, and a few other Maven developers, and I think it's time we started