Lally Singh wrote:
On 9/26/07, Wendy Smoak <[EMAIL PROTECTED]> wrote:
(There *is* a doc standard that they have to pass prior to being
promoted from the sandbox and released. Does it need to be changed?)
YES.
Right now the docs tend to look 100% autogenerated and be 0% useful.
Well, that's because a lot of it *is* generated. That in combination
with a site disposition that we agreed upon makes the plugin sites look
similar. But that should be a good thing!
It's tough to find the useful material in all the autogenerated and
unnecessary fluff. Just a description of all the options (e.g.
reference documentation) and an example is all I'm asking for.
Every plugin has (auto-generated) reference documentation of the
available options. Click the "Goals" link in the menu to go there. Then
click on the goal that you are interested in. All plugins at the Maven
project work this way.
That being said, many options lack good descriptions. This is where I
see that you, the user community, can help us improve this. We need to
find a good way to find out which specific options that need better
descriptions.
Some boilerplate in there in how to set up plugins (in general) would
also be nice.
On 9/26/07, Rodrigo Madera <[EMAIL PROTECTED]> wrote:
Make the Better Builds book available directly through the Maven site
WITHOUT registration.
That'd be nice. Even before hearing back from the respective authors,
HOW ABOUT LINKING TO THEM???? I don't mind registering. I mind
finding out about the book randomly from the mailing list or google.
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
