Re: [vote] Move maven-runtime out of the sandbox and release 1.0-alpha-1

[Dennis Lundberg <de...@apache.org>]

Mark Hobson wrote:
> 2008/4/29 Wendy Smoak <ws...@gmail.com>:
>> On Mon, Apr 28, 2008 at 5:40 PM, Mark Hobson <ma...@gmail.com> 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: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
> 
> 


-- 
Dennis Lundberg

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org

Re: [vote] Move maven-runtime out of the sandbox and release 1.0-alpha-1

[Mark Hobson <ma...@gmail.com>]

2008/5/1 Dennis Lundberg <de...@apache.org>:
>  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/

Okay, sure, I'll knock up some documentation before I call another vote.

Cheers,

Mark

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org