Mark Hobson wrote:
2008/4/29 Wendy Smoak <[EMAIL PROTECTED]>:
On Mon, Apr 28, 2008 at 5:40 PM, Mark Hobson <[EMAIL PROTECTED]> wrote:

 >  4hrs to go.. anyone?

 Does it have docs? How would I test it?

It has Javadoc but no site doc.  I figured that since only a handful
of shared components have site doc and that this is an alpha release
it probably wasn't that imperative, correct me if I'm wrong.

That might be the case, but it's something that we need to change. I've written docs for some of the shared components, and the shared parent now includes a site.xml including the necessary navigational and presentational aids.

In my opinion we should require a site for every release, even for shared components and for alpha releases. It doesn't have to be all that complicated - just include a short description and a basic usage example. See the site of the, not yet released, shared component doxia tools for an example. Its not much but it's better than nothing.

  http://maven.apache.org/shared/maven-doxia-tools/


Take a look at the unit tests for some examples of usage, specifically
DefaultMavenRuntimeTest.

Cheers,

Mark

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




--
Dennis Lundberg

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

Reply via email to