2. N/A
4. A. (emacs)
3. xdoc has been sufficient to this point, but we may outgrow the format in the future. As was pointed out in a different reply, a schema for xdoc would be a "Good Thing" (TM), preferably XML Schema but a DTD would be a good first step. A distant second place for this type of documentation is DocBook; I feel it's too broad for most programmers to use effectively (in our shop programmers are responsible for this kind of documentation), including the "simple" version of DocBook.
-Jan
At 11:15 AM 9/7/2004, Carlos Sanchez wrote:
Hi all,
I'd like to start a thread about how do you write your documentation to be integrated with Maven. Maybe I can give away some GMail invites to those participating, it's not much, but as you may know open source doesn't pay the bills, at least not MY bills ;-)
1. What format do you use to write documentation? A. xdoc B. html C. docbook D. latex E. who needs documentation?
2. If you didn't choose A, how do you transform your doc to be integrated in a Maven powered site? A. html2xdoc B. docbook plugin C. sdocbook plugin D. latex plugin E. other, please say what F. I don't transform, only link to my docs G. I write it again
4. What tool do you use to write the docs? A. notepad / vi and similar B. one that is not WYSIWYG (please say what) C. a WYSIWYG editor (please say what) D. an hex editor
3. Would you like to use another format instead of answered in (1) and why?
Leave your name here if you'd like a Gmail invite.
Regards
Carlos Sanchez A Coru�a, Spain http://www.jroller.com/page/carlossg/Weblog
Oness Project http://oness.sourceforge.net
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Jan Nielsen System Architect Luminis Solutions SunGard SCT
[EMAIL PROTECTED] http://www.sungardsct.com
+1 801 257 4155 (voice) +1 801 485 6606 (facsimile)
90 South 400 West Salt Lake City, UT 84101
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
