Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-12 Thread Carlos Sanchez
I think that after this bunch of releases we'll reach a good state of stability. I found pretty useful to comment on the jira issues with patches asking for unit tests and docs, saying that without them it'd take lot longer to get the patch applied (or it wouldn't be applied at all). People usual

Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-12 Thread John Casey
I've already got a start at a more comprehensive set of documentation for the assembly plugin on localhost. I'll try to flesh it out today and get it committed...it shouldn't take more than a day to document a plugin, even one as complex as the assembly plugin. -john On 5/8/06, Brett Porter <[EM

Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Brett Porter
Mike Perham wrote: Brett, I appreciate the concern on the subject. My main concern is not thorough documentation - it's basic "what is this and what is it for" doucmentation. Adding goals to a plugin but not including basic user documentation just perpetrates Maven's reputation as a poorly docu

Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Brett Porter
Mike Perham wrote: Brett, I appreciate the concern on the subject. My main concern is not thorough documentation - it's basic "what is this and what is it for" doucmentation. Adding goals to a plugin but not including basic user documentation just perpetrates Maven's reputation as a poorly docu

RE: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Mike Perham
ing SVN edge but once they are released I can start contributing to the documentation myself. -Original Message- From: Brett Porter [mailto:[EMAIL PROTECTED] Sent: Monday, May 08, 2006 6:43 PM To: Maven Developers List Subject: re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Brett Porter
Lukas Theussl wrote: In principle I think that 3) should be enforced. Always. Releasing components in an undocumented state means releasing them in an unfinished state, which is shortsighted and irresponsible. It is unfair towards users who don't regularly read the mailing list. I totally ag

Re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Lukas Theussl
[snip] We should never have gotten into this situation, but I think the best balance is: 1) do as much doc as is practically possible before the release 2) release as is to satisfy users demanding the fixes/features and to reduce load on the users list (many faqs are addressed by things like

re: plugin docs was: [vote] Release maven-assembly-plugin 2.1

2006-05-08 Thread Brett Porter
Mike Perham wrote: -1 due to missing documentation. John, I built the site but I don't see any documentation on the new features and how to use them. Did I just miss something? No, they weren't updated by those contributing patches. This mostly occurred before we had our previous discussio