On Thu, 2004-03-18 at 10:33, Sonnek, Ryan wrote:
> What about adding a column to the documentation area for "required" tags?
> This would allow the layout to be verbose and users can click on the tag
> name to see if it is required.  the documentation already has "Optional"
> next to many of the tags, but it is not visually distinct since it is in the
> description column.  If a new column was added for the sole purpose of
> displaying the required status, it'd be a bit easier to read.

Ultimately the page describing the model will be generated from this:

http://cvs.apache.org/viewcvs.cgi/maven-components/maven-model/maven.mdo?rev=1.22&view=auto

I am already generating the model sources, the XSD, the xpp3
unmarshaller and marshaller and the xdoc:

http://maven.apache.org/maven.html

Certainly not finished by any stretch of the imagination, but the
maven.mdo will be augmented to provide any information that is useful.
Optional fields will definitely be added as they are required for the
correct generation of the XSD:

http://maven.apache.org/~jvanzyl/maven.xsd

As you can see there's nothing there to allow optional fields yet, but
it's coming.

Ultimately, I want any artifact that is useful and stems from the model
to be generated so that it remains up-to-date with changes in the model.
This has been the biggest problem with Maven which I hope remedy soon.

So even that sample full document at the top of Dion's can be generated
and I will incorporate that if desired. This week and next week are
plugin weeks the following week will be work on the new xdoc plugin:

http://cvs.apache.org/viewcvs.cgi/maven-components/maven-xdoc/

Which will produce nice sites like:

http://groovy.codehaus.org/

And do it pretty much instaneously. I can currently generate the xhtml
for the Maven site in under a second.

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

-- 
jvz.

Jason van Zyl
[EMAIL PROTECTED]
http://maven.apache.org

happiness is like a butterfly: the more you chase it, the more it will
elude you, but if you turn your attention to other things, it will come
and sit softly on your shoulder ...

 -- Thoreau 


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

Reply via email to