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

[Karen Collier]

That sounds like a session I'd like to attend. :) 

Karen C 

----- "Karen Schneider" <kgs at esilibrary.com> wrote: 
> The conference idea (slaps forehead) that's inspired! That sounds like at least one program -- heck it could even be a Hackfest, a kind of gonzo instruction class involving installing a free open source XML editor, applying templates, working in XML, etc. (There's no reason Hackfests need to be limited to development!) 
> 
> thanks, Catherine! 
> 
> Thoughts from others in the community? 
> 
> Karen S. 
> 
> 
> On Thu, Jan 29, 2009 at 2:38 PM, Catherine Buck Morgan < Cmorgan at statelibrary.sc.gov > wrote: 
> 


> 


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 
> 
> 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 
> 

> -- 
> -- 
> | 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 
> 

-- 
Karen Collier 
Public Services Librarian 
Kent County Public Library 
408 High Street 
Chestertown, MD 21620 
410-778-3636 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://libmail.georgialibraries.org/pipermail/open-ils-general/attachments/20090212/2381a2f7/attachment.htm