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

Fri Mar 4 23:28:40 EST 2011

Well... in regards to suggested revisions by DIG the important factor to remember is that there is probably only a handful of Evergreen acquisitions experts in the entire world or those with enough experience to revise what has been created. I am not sure who if anyone currently actively involved in DIG would be able to provide expert level content revisions. That being said, If a group could be formed to review, test and perhaps merge the best of both documents that might be one approach. However, given the voluntary nature of DIG, it might take a while to review the content given that the acquisition document from GPLS is 45 pages alone. During the content review phase among a small group of acquisition specialists, if we decide to go this route and can round up these specialists, could review the documents in word / open office /basic text format until a final version can be merged into once version. (We could move the document into wiki format as suggested by some, but it seems like an awful lot of work to convert to that format for review of such a large document.)
Once content is refined, it can be forwarded to the DocBook conversion team (me) to be converted to DocBook XML and  added to the official documentation.

A second approach would be to convert and add both documents side by side  "as is" into the official documentation to allow quicker publication and inclusion in the official Evergreen documentation. Then, the documentation could be reviewed by the larger community and refined gradually through feedback by the community and users of the documentation. It could then be eventually merged into one near perfect document through gradual evolution based on feedback from users. I would lean towards this approach and would expect the documentation "as is" to get into the official docs within several months. The other approach might take longer time to reach publication depending on the number of perfectionists on the content review team.

The GPLS documentation looked pretty good and will help a lot of users and I am sure both documents have very useful and critical information for Evergreen users trying to get their heads around acquisitions.

Regards,
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: loriayre at gmail.com [loriayre at gmail.com] On Behalf Of Lori Bowen Ayre [lori.ayre at galecia.com]
Sent: March 4, 2011 6:37 PM
To: Evergreen Discussion Group
Cc: Soulliere, Robert; open-ils-documentation at list.georgialibraries.org
Subject: Re: [OPEN-ILS-GENERAL] Acquisitions and Serials Documentation Drafts Now Available

Robert,

I'm happy to give DIG the set of procedures I have from KCLS, and I guess you can snag the PINES/ESI  *.docs from the wiki.  Would it reasonable to have the DIG get back to everyone on this list with suggested revisions as well as recommendations for where this stuff all lives?

Advise if I'm stepping out of line...just trying to keep this discussion moving forward toward some kind of resolution!

Lori

On Fri, Mar 4, 2011 at 8:12 AM, Soulliere, Robert <robert.soulliere at mohawkcollege.ca<mailto: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.

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<mailto:robert.soulliere at mohawkcollege.ca>
Telephone: 905 575 1212 x3936
Fax: 905 575 2011
________________________________________
From: open-ils-general-bounces at list.georgialibraries.org<mailto:open-ils-general-bounces at list.georgialibraries.org> [open-ils-general-bounces at list.georgialibraries.org<mailto:open-ils-general-bounces at list.georgialibraries.org>] On Behalf Of Lori Bowen Ayre [lori.ayre at galecia.com<mailto: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><mailto: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><mailto: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><mailto: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><http://www.galecia.com/>
(707) 763-6869 // Lori.Ayre at galecia.com<mailto: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
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Mary Llewellyn

Mary Llewellyn
Database Manager
Bibliomation, Inc.
Middlebury, CT

mllewell at biblio.org<mailto:mllewell at biblio.org><mailto: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><http://www.galecia.com/>
(707) 763-6869 // Lori.Ayre at galecia.com<mailto:Lori.Ayre at galecia.com><mailto:Lori.Ayre at galecia.com<mailto: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.

--

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