[OPEN-ILS-GENERAL] Documentation proposal -- input requested

[Catherine Buck Morgan]

Karen,

I was reading this last night and checking out Docbook. To say this is a
timely topic would be an understatement... I love the title, by the
way-The Book of Evergreen. 

 

One thing that stood out particularly was the ability to translate the
documentation to word and pdf. (I've decided I'm the "tween
generation"... remember and appreciate the good old paper manual, like
the convenience of online contextual documentation, but still want to be
able to scribble my notes in the margins of how it really works for my
system.... ) I really think you're on the right road with the XML
platform. 

 

Using (or an intro to) Docbook might be a good topic for the
conference... 

 

--Catherine.

 

--

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. 

 

 

 

From: open-ils-general-bounces at list.georgialibraries.org
[mailto:open-ils-general-bounces at list.georgialibraries.org] On Behalf Of
Karen Schneider
Sent: Thursday, January 29, 2009 8:47 AM
To: Evergreen Discussion Group; Evergreen Development Discussion List;
Public Open-ILS documentation discussion
Subject: [OPEN-ILS-GENERAL] Documentation proposal -- input requested

 

Hi folks, two weeks back there were a flurry of posts about an Evergreen
documentation project plan. I will plan a webinar for a conversation
about this proposal, but if you have thoughts to share on or off the
list, your input would be very welcome. Input could range from "Yes,
that's a good idea -- carry on" to "I suggest X about Y" to "This is the
most ghastly proposal I have seen in my X years working in libraries." 

This is the proposal: 

http://docs.google.com/Doc?id=ddzqk523_264f2vk5vpn

Note that there are any kind of top-level decisions to be made, with
corollary activity that follows, and it's not even a given we call the
documentation The Book of Evergreen (especially if it turns out to be in
volumes...). That has been its working title, and in the absence of
better ideas, etc. etc., but a discussion about the title would also be
timely. 

Also, Betty Ing, a documentation intern at Project Conifer, has
published a comparison of Style Guidelines for Fedora and Book of
Evergreen. For those who missed her post (to the documentation list) I
published her cross-walk here: 

http://spreadsheets.google.com/pub?key=pqvVF5hSEbDO6MlrXHXxDUg
<http://spreadsheets.google.com/pub?key=pqvVF5hSEbDO6MlrXHXxDUg> 

This crosswalk reinforces the suggestions in the proposal. 

We've seen some excellent documentation emerging from various parts of
the Evergreen community, and channeling it into an intentional project
integrated with larger Evergreen efforts would be excellent. 


-- 
-- 
| Karen G. Schneider
| Community Librarian
| Equinox Software Inc. "The Evergreen Experts"
| Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
| E-Mail/AIM: kgs at esilibrary.com
| Web: http://www.esilibrary.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://libmail.georgialibraries.org/pipermail/open-ils-general/attachments/20090129/3e6019dd/attachment.htm