[OPEN-ILS-GENERAL] Book of Evergreen-Bravo!

Marlene Coleman mcoleman at bcgov.net
Fri Jan 30 14:54:55 EST 2009


Bravo Karen!!  As a newbie attempting a migration project, I'm certainly appreciating what others have already done.  I'd love just one site or linked sites we could go to and find information, and not have to recreate a wheel...fire....whatever.  The community sources site on the website was a start, but standardizing the documentation and creating an online "Book of Evergreen" for the community is definitely needed.  I really don't want to dig into "code" to figure out the meaning of a field in Evergreen. :)  
 
A glossary of Evergreen terms/fields (which I had mentioned in a previous email) would be my first request/suggestion.  (To the group, if this already exists I haven't located it, please advise.)
 
Thanks!
 
Marlene
 
Marlene F. Coleman
Evergreen Project Manager
Branch Manager, Beaufort Branch
Beaufort County Library
311 Scott Street
Beaufort, SC 29902
mcoleman at bcgov.net
843-470-6544
www.beaufortcountylibrary.org <http://www.beaufortcountylibrary.org/> 
For Learning ~ For Leisure ~ For Life

________________________________

From: open-ils-general-bounces at list.georgialibraries.org on behalf of open-ils-general-request at list.georgialibraries.org
Sent: Fri 1/30/2009 10:27 AM
To: open-ils-general at list.georgialibraries.org
Subject: Open-ils-general Digest, Vol 31, Issue 17



Send Open-ils-general mailing list submissions to
        open-ils-general at list.georgialibraries.org

To subscribe or unsubscribe via the World Wide Web, visit
        http://libmail.georgialibraries.org/mailman/listinfo/open-ils-general
or, via email, send a message with subject or body 'help' to
        open-ils-general-request at list.georgialibraries.org

You can reach the person managing the list at
        open-ils-general-owner at list.georgialibraries.org

When replying, please edit your Subject line so it is more specific
than "Re: Contents of Open-ils-general digest..."


Today's Topics:

   1. Re: Documentation proposal -- input requested
      (Catherine Buck Morgan)
   2. Re: Documentation proposal -- input requested (Karen Schneider)


----------------------------------------------------------------------

Message: 1
Date: Thu, 29 Jan 2009 14:38:30 -0500
From: "Catherine Buck Morgan" <Cmorgan at statelibrary.sc.gov>
Subject: Re: [OPEN-ILS-GENERAL] Documentation proposal -- input
        requested
To: "Evergreen Discussion Group"
        <open-ils-general at list.georgialibraries.org>
Message-ID:
        <713E639453AB8D45AB02FCBD20BAF90C013DF4B2 at jocasta.statelibrary.sc.gov>
Content-Type: text/plain; charset="us-ascii"

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 <http://www.esilibrary.com/> 

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

------------------------------

Message: 2
Date: Fri, 30 Jan 2009 09:36:37 -0500
From: Karen Schneider <kgs at esilibrary.com>
Subject: Re: [OPEN-ILS-GENERAL] Documentation proposal -- input
        requested
To: Evergreen Discussion Group
        <open-ils-general at list.georgialibraries.org>
Message-ID:
        <e28b6dac0901300636n31ace5c8pabde45aa59341fbb at mail.gmail.com>
Content-Type: text/plain; charset="windows-1252"

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 <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 <http://www.esilibrary.com/> 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://libmail.georgialibraries.org/pipermail/open-ils-general/attachments/20090130/3e36e044/attachment.htm

End of Open-ils-general Digest, Vol 31, Issue 17
************************************************


-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/ms-tnef
Size: 14757 bytes
Desc: not available
Url : http://libmail.georgialibraries.org/pipermail/open-ils-general/attachments/20090130/458c6f47/attachment-0001.bin 


More information about the Open-ils-general mailing list