>>>
Re the documentaion - what do ppl think about changing
the layout?  I
think maybe a framed layout similar to ants tasks,
with all the valid tags
on a left frame, and then more detailed parameter
description might be
better...?  The current layout worked well with many
small tags, but now
that we have fewer larger tags I think a change would
be warranted.  I'm
happy to do this, but as its a sizable change I
wouldn't mind some other
opinions before I go doing anything (o:
<<<

Good idea Dmitri.

I propose something like this:
A simple two pane frameset like Ant's. In the left
frame:

Introduction
Using XDoclet              ->things like an example
and what jars are needed, samples, etc
Built-in Tasks
+       <ejbdoclet/>
+       <webdoclet/>
+       <jmxdoclet/>
+       etc
Migration from EJBDoclet
Extending XDoclet
+       Architecture
+       Template how-to
+       Template Tags           ->link to generated templates.html
License
Resources                               -> links to mailing lists, download iste
Who we are                              -> Committers/contributers/Emeritus

Clicking on ejb/web/jmxdoclet refreshes the left
frame. For ejbdoclet:

Introduction
Using <ejbdoclet/>              -> short desciption on @tags and
setting up <ejbdoclet/>
Standard Tags
+       bean
+       pk
+       home                            -> not necessarily one to one with
ejb:blabla tags, just a logical grouping
+       etc
Vendor Tags
+       jboss
+       orion
+       etc
Task Parameters
Standard Elements
+       <dataobject/>
+       <entitypk/>
+       etc
Vendor Elements
+       orion
+       jboss
+       etc

Note that let's say for jboss, we'll have a
jboss.html, with two sections: tags and <jboss/>
element, so jboss-specific stuff are near each other.
It's also true for other stuff, ejb:dataobject @tags
then in the same html the <dataobject/> element.
ejb:bean and others that are used by all are grouped
separately in a single file.

Ara.

__________________________________________________
Do You Yahoo!?
Get email alerts & NEW webcam video instant messaging with Yahoo! Messenger
http://im.yahoo.com

_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel

Reply via email to