[OPEN-ILS-DOCUMENTATION] Quote about DocBook

[Catherine Buck Morgan]

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
cmorgan at statelibrary.sc.gov
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: open-ils-documentation-bounces at list.georgialibraries.org [mailto:open-ils-documentation-bounces at list.georgialibraries.org] 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
<e28b6dac0905150510m1ab2735du7e3010edceab96e5 at mail.gmail.com>, Karen Schneider
<kgs at esilibrary.com> 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
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation