Thomas V's Jira Torque-91 issue raised the priority on a Torque project
I've had in mind for a while, better documentation for the schema DTD.
 
I'm strongly thinking about using dtddoc (dtddoc.sf.net) to do this. 
This is a well know/accepted documentation tool (used by the
Struts project) that allows you to put Javadoc type tags into
XML comments and then generate documentation from them.
 
The only minor issue I can see is how to automate the document
generation for the site.  There is a Maven 2 plugin and the basic
ant task jar is available via the Maven repository.  For full 
compatibility, I'll probably go with adding a site dependancy
for the Ant task and using that.
 
Does anyone have objections to dtddoc?
 
Greg Monroe <[EMAIL PROTECTED]> (919)680-5050
C&IS Solutions Team Lead
Duke Corporate Education, Inc.
330 Blackwell St.
Durham, NC 27701

 

Duke CE Privacy Statement
Please be advised that this e-mail and any files transmitted with it are 
confidential communication or may otherwise be privileged or confidential and 
are intended solely for the individual or entity to whom they are addressed.  
If you are not the intended recipient you may not rely on the contents of this 
email or any attachments, and we ask that you  please not read, copy or 
retransmit this communication, but reply to the sender and destroy the email, 
its contents, and all copies thereof immediately.  Any unauthorized 
dissemination, distribution or copying of this communication is strictly 
prohibited.


Reply via email to