Here are some random thoughts.
What would happen if "mvn help" printed out
.....
mvn faq <plugin> - faq for the plugin
mvn myfaq - your personal faq (creates a personal site/maven-faq.xml )
mvn faqreport - reports something that you think should be an faq
....
mvn faqreport would generate a xml formated file with the person's faq (with
answer if they have it) so that common faq could be managed and
disseminated.
Random question ......
***How come mvn has all these facilities for uploading/downloading files
.... and it is not being applied to spread documentation? **
** how come mvn doesn't have any mvn specific way to contribute patches to
either documentation, maven core or a plugin? Shouldn't I be able to run
"mvn sendpatch" in a plugin's directory and have it do a diff with svn and
send the patch to jira ?
On 9/27/07, Wayne Fay <[EMAIL PROTECTED]> wrote:
>
> > > How can you help people who ask this question (and others
> > > like it)? I agree that _more_ documentation is not
> > > necessarily the magic bullet that many believe it is.
> >
> > The argument that "some people don't read documentation so there is no
> > point in writing any more" is a non-sequitor. Please don't fall into
> > that trap.
>
> I simply want to make sure that we remember all the various
> "documentation problems" while discussing this topic...
>
> One possible way to fix the problem I've mentioned ("annotations are
> not supported in -source 1.3") would be to add code in compiler plugin
> that watches for that specific problem, and instead of simply printing
> that generic error message, it prints a "better" error message that
> tells the person how to configure things to make it go away, or
> provides a link to the Wiki with a complete discussion and the
> configuration.
>
> I don't think that is a reasonable way to fix all the problems people
> run into, but for the most common cases, it might make some sense.
> What other common cases might be handled with this approach?
>
> Wayne
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
