I agree, we need more documentation and reStrucText is an easy-fast way to get started. Personally I like using XML. I use the XML for some internal documenetation, and it is also very fast to write. I have been using to doc layout of the gentoo linux project, becuase it is easy and well supported. Take a look at http://www.gentoo.org/doc/xml-guide.html and http://www.gentoo.org/projects/xml.html I used it to generate http://webware.metrony.com/tutorials/calPopUp.htmlAnyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, but more importantly it's comfortable to write. Keeping the documentation up-to-date is the most essential part.
But I would go w/ reStruct to get some documentation going and we can always convert from reStruct -> xml if we need to later.
-------------------------------------------------------
This sf.net email is sponsored by: Influence the future of Java(TM) technology. Join the Java Community Process(SM) (JCP(SM)) program now. http://ad.doubleclick.net/clk;4729346;7592162;s?http://www.sun.com/javavote
_______________________________________________
Webware-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/webware-devel
