[OPEN-ILS-DOCUMENTATION] [OPEN-ILS-GENERAL] Acquisitions and Serials Documentation Drafts Now Available

[Mike Rylander]

On Fri, Mar 4, 2011 at 11:12 AM, Soulliere, Robert
<robert.soulliere at mohawkcollege.ca> wrote:
>  I think having the discussion on the Documentation list is important as well.
>
> The hope is that the Acquisitions. documentation would be included as part of the official documentation for 2.0:
> http://docs.evergreen-ils.org/2.0/draft/html/
>
> I think it would be best to get the documentation into DocBook XML format which could then be processed in both HTML and PDF as part of the official documentation.
>

For ruby-ites out there:
http://juretta.com/log/2006/08/10/convert_microsoft_word_to_docbook_xml_using_ruby_and_openoffice/

So, we could automate the conversion.

There are companies that will convert from Word to DocBook as well,
one of which (says google) is:
http://www.whiplashtech.com/technologies.html

--miker

> Would the DIG list be a good place to have the discussion and provide feedback on documentation?
>
>
> Robert
>
> Robert Soulliere, BA (Hons), MLIS
> Systems Librarian
> Mohawk College Library
> robert.soulliere at mohawkcollege.ca
> Telephone: 905 575 1212 x3936
> Fax: 905 575 2011
> ________________________________________
> From: open-ils-general-bounces at list.georgialibraries.org [open-ils-general-bounces at list.georgialibraries.org] On Behalf Of Lori Bowen Ayre [lori.ayre at galecia.com]
> Sent: March 4, 2011 10:29 AM
> To: Evergreen Discussion Group
> Subject: Re: [OPEN-ILS-GENERAL] Acquisitions and Serials Documentation Drafts Now Available
>
> Mary, I'm happy to share them (on KCLS' behalf).  Question:  Would it be useful for me to post these on the wiki with the "official draft" of Acq documentation?  I'm wondering if it would be useful to have a place to post info about procedures or potential workflows with the official documentation.  I see these two types of documents very differently but both are equally important.
>
> And, is there a protocol in place for providing feedback on the draft documentation that is posted?  Seems like publicly sharing our comments would be useful. I'm wondering if the documentation could be provided on a wiki and in wiki format instead of PDF?  I'm thinking of the way Dan Scott put up the proposed rules of governance recently so we could all provide feedback. That would make all feedback visible and easier to keep track of for whomever gets to consolidate that feedback.
>
> Should we be having this discussion on the Documentation list too?
>
> Lori
> (speaking largely in her role as a Communications Committee member!)
>
>
> On Fri, Mar 4, 2011 at 7:07 AM, Mary Llewellyn <mllewell at biblio.org<mailto:mllewell at biblio.org>> wrote:
> Yes, please!!!!
>
>
>
> At 10:02 AM 3/4/2011, Lori Bowen Ayre wrote:
> Hi All,
>
> I just got my hands on a copy of what is more like a procedures guides than "documentation" for ordering, receiving and invoicing.  It is from KCLS.  I don't want to introduce any confusion finalizing the documentation PINES/ESI has put together.  But if anyone would like a copy of of the workflow KCLS is using, let me know.
>
> Lori
>
> On Thu, Mar 3, 2011 at 5:53 PM, McKinney, Elizabeth < emckinney at georgialibraries.org<mailto:emckinney at georgialibraries.org>> wrote:
>
> Draft documentation for acquisitions and serials is now available at
> http://evergreen-ils.org/dokuwiki/doku.php?id=start
>
> See the links to the three PDF files in the Documentation section.
>
> Please note that these are drafts created by Equinox on behalf of the Georgia Public Library Service.  We will have a 30 day review period before these documents are finalized and become resources of the Evergreen community.  Please don't hesitate to give us your feedback.
>
> Elizabeth
>
> Elizabeth McKinney
> PINES Program Director
> Georgia Public Library Service
> A Unit of the University System of Georgia
> 1800 Century Place, Suite 150
> Atlanta GA 30345
> 404.235.7141
> emckinney at georgialibraries.org<mailto:emckinney at georgialibraries.org>
> http://www.georgialibraries.org/
>
>
>
>
>
>
>
>
> --
>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=
> Lori Bowen Ayre // Library Technology Consultant
> The Galecia Group // www.galecia.com<http://www.galecia.com/>
> (707) 763-6869 // Lori.Ayre at galecia.com<mailto:Lori.Ayre at galecia.com>
>
> Specializing in open source ILS solutions, RFID, filtering,
> workflow optimization, and materials handling
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
>
> Mary Llewellyn
>
> Mary Llewellyn
> Database Manager
> Bibliomation, Inc.
> Middlebury, CT
>
> mllewell at biblio.org<mailto:mllewell at biblio.org>
>
>
>
> --
>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=
> Lori Bowen Ayre // Library Technology Consultant
> The Galecia Group // www.galecia.com<http://www.galecia.com/>
> (707) 763-6869 // Lori.Ayre at galecia.com<mailto:Lori.Ayre at galecia.com>
>
> <mailto:Lori.Ayre at galecia.com>Specializing in open source ILS solutions, RFID, filtering,
> workflow optimization, and materials handling
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
>
>
> This E-mail contains privileged and confidential information intended
> only for the individual or entity named in the message.  If the reader
> of this message is not the intended recipient, or the agent responsible
> to deliver it to the intended recipient, you are hereby notified that
> any review, dissemination, distribution or copying of this communication
> is prohibited.  If this communication was received in error, please
> notify the sender by reply E-mail immediately, and delete and destroy
> the original message.
>



-- 
Mike Rylander
 | VP, Research and Design
 | Equinox Software, Inc. / Your Library's Guide to Open Source
 | phone:  1-877-OPEN-ILS (673-6457)
 | email:  miker at esilibrary.com
 | web:  http://www.esilibrary.com