I guess another argument in favour of Docbook is peer pressure. When making the rounds around the documentation sites, I found that at the recent Open Source Documentation Summit, the Gnome Documentation Project, Linux Documentation Project, and FreeBSD folks have all agreed to use DocBook (in its XML flavour). With that kind of support behind docbook and its tools, it may be silly to use anything less[4]. On this list, I've heard a chorus of "DocBook is good," along with a few "I'm not sure but I'll learn it if I have to" remarks. The as-yet-hypothetical "might scare contributers" remark can be addressed if we have people who are willing to do plaintext or html to docbook conversions. (Yes, I will do such conversions.) I guess we're still waiting to hear the Grand High Yoshman's words. [Kevin checks the latest mail. Now it seems we have a help template file in HTML. Okay. Uh-oh, it's under a non .gimp.org domain, Sven will frown about that.] A few other pointers to resources: The Open Source Writers Group serves as a pool of authors and editors which we may dip in to if we need more hands: http://oswg.org/ Piers has tracked down an introduction to DocBook as provided by the LDP's Author's Guide: http://linuxdoc.org/LDP/LDP-Author-Guide/ The "Definitative Guide to DocBook", a reference guide, may be found at http://docbook.org/ Cheers, - Kevin Footnotes: 1. Reports on the Open Source Documentation Summit: http://mail.gnome.org/pipermail/gnome-doc-list/2000-July/001502.html http://www.oreilly.com/frank/oscon_summit.html 2. Gnome Documentation Project (GDP): http://developer.gnome.org/projects/gdp/ 3. Linux Documentation Project (LDP. These are the "HOWTO" people.): http://linuxdoc.org/ 4. Unless you're the FSF, in which case you're committed to using TeXinfo forever. 5. Its times like this that make me think maybe HTML e-mail isn't such a bad idea after all. -- Kevin Turner <acapnotic@xxxxxxxxxxxxxxxxxxxxx> | OpenPGP encryption welcome here Plug-ins: They make GIMP do stuff. http://gimp-plug-ins.sourceforge.net/ This list is archived at http://marc.theaimsgroup.com/?l=gimp-developer To unsubscribe, mail gimp-developer-unsubscribe@xxxxxxxxxxxxxxxx
