Now this looks very cool. If it works as advertised, it would certainly alleviate the technical issues for what I hope are our very talented documentation developers, allowing them to focus on content and not coding. (Not that someone can't do both... :) )
-- Catherine Buck Morgan Director, Division of Innovation, Technology & Library Services South Carolina State Library POB 11469, 1500 Senate Street, Columbia, SC 29211 Phone: 803-734-8651 | Fax: 803-734-4757 [email protected] www.statelibrary.sc.gov The South Carolina State Library is a national model for innovation, collaboration, leadership and effectiveness. It is the keystone in South Carolina's intellectual landscape. -----Original Message----- From: [email protected] [mailto:[email protected]] On Behalf Of Grant Johnson Sent: Friday, May 15, 2009 12:20 PM To: Public Open-ILS documentation discussion Subject: Re: [OPEN-ILS-DOCUMENTATION] Quote about DocBook While I find myself agreeing with the structure argument for docbook, I feel the need to say that there needs to be an easy point of entry for programmers and "writers" This might help... And standard templates can then be published and shared. http://xml.openoffice.org/xmerge/docbook/UserGuide.html -- F. Grant Johnson Systems Coordinator Robertson Library University of Prince Edward Island >>> On 5/15/2009 at 9:10 AM, in message <[email protected]>, Karen Schneider <[email protected]> wrote: > Since last fall I've been lurking on discussion lists for open-source > documentation projects (e.g. Fedora), open source standards such as DocBook, > and tool-specific lists such as oXygen XML editor. The following quote, from > someone involved in a major open source project, sums up the assessment I > get from people who have spoken with me about DocBook: > > "The reason why DocBook is the tool of choice is because it gets the job > done and everything else is worse. [Most of] the tools are free software. > You get the output formats you need: HTML, HTML Help (for Windows), > tolerable print, man pages, plain text. It's easy to work with for a > decentralized team because the sources are plain text that you can check > into CVS. > > "Everything else is worse: Wikis are only online. Word is just a terrible > tool altogether, and you can't run cvs diff on it. LaTeX is weird, so is > Texinfo. Everything else is either very limited or unfinished or > nonexistent." _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
